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РНЕҒАСЕ 


Тһе Sinclair ZX80 microcomputer has been described as bringing а breath 
of fresh air to the personal computer scene. |ts compactness, price and 
ease of use have been reflected in the large number of orders placed in 
the few months following its launch. 


“Тһе ZX80 Companion'' arose from the authors’ experience in obtaining 
one of the first ZX80 kits and through many hours of use at home and in 
the college classroom. It is intended to be a manual for the broad 
spectrum of ZX80 owners, from the electronics specialist wishing to 
learn about microcomputers, to the computer professional buying his own 
system for the first time, and most particularly to the person wanting to 
use a computer in his own home. Considerable interest has also been 
shown by educationalists from primary up to tertiary levels. Much of 
the material in this volume has grown from course notes used in intro- 
ducing college students to BASIC programming and microcomputers. 
The ZX80 enthusiast will also find much useful information, particularly 
in Chapters 3 and 4. 


~The background of the authors mirrors the variety of backgrounds of 
ZX80 owners. Terry Trotter graduated from Leeds Polytechnic with a 
BSc in Electronic Engineering and has several years' experience in 
designing and using microprocessor-based systems. Bob Maunder has an 
MSc in Computer Science from Birmingham University and has experi- 
ence in technical and commercial programming, including CAL tech- 
niques, and latterly as a college lecturer. lan Logan claims to be a typical 
ZX80 enthusiast: he has no professional connection with computing but 
isa member of his local hobby computer group, and is a general medical 
practitioner. 


Thanks are due to Clive Sinclair for his permission to use tables of 
character codes from the ZX80 Operating Manual, to Pat Crabb for two 
programs used in Chapter 3, and to Margaret Lee for her invaluable assis- 
tance with typing. 
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INTRODUCTION 


The manual is arranged so that an intending user of the ZX80 entering 
computing for the first time may start using the system quickly, and 
then gradually gain a better appreciation of the machine and its facilities. 
The informed computer user will find the later sections particularly 
useful in applying his knowledge to the ZX80. 


The first chapter introduces the user to the ZX80 with instructions on 
how to load and run packaged programs. Chapter twc then directs the 
reader's attention to the basic principles of computers and of program- 
ming theory. The largest chapter is the third, being a detailed study of 
ZX80 BASIC beginning at a simple level and ending with simple machine 
code programming features. Chapter four is aimed at the enthusiast 
wanting to know the workings of the ZX80 monitor and thus get the 
best out of the system. Chapter five guides the owner building his 
ZX80 from kit form and is also intended to inform users interested in 
the hardware side of the system. The volume ends with a collection of 
fully-documented ZX80 programs from the LINSAC catalogue, in 
Chapter six. 


The authors welcome correspondence on any matters raised in the book 
and may be contacted through LINSAC, 68 Barker Road, Middlesbrough 
155 БЕЗ. 


То facilitate study of the manual, portions describing features of the 
ZX80 more suitable for advanced users are marked with a line in the 
left-hand margin, as shown. This convention is not followed in Chapter 
four since the entire chapter is in this category. 


уха 
Pete! 
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CHAPTER ONE — OPERATING THE 2Х80 


11 INTRODUCTION 


Many ZX80 users will wish to start by using the computer with рге- 
packaged programs. This chapter details all necessary information for 
setting up the system and loading and running such programs. 


1.2 EQUIPMENT 


T he ZX80 comes complete with leads for connection to the MIC and 
EAR sockets of a normal cassette recorder and to the aerial socket of a 
television set. Figure 1 shows a normal arrangement. 


Television 


Either a colour or black and white television set may be used, but the 
latter tends to give a better quality picture. The set should be tuned to 
channel 36 UHF by means of the normal tuning controls. There is no 
sound output so the volume should be set to minimum. Connect the 
single aerial-type lead to the video socket of the ZX80 and to the aerial 
socket of the televsion. The video output is designed to provide a 
picture of 24 lines of 32 characters. 


Cassette Recorder 


A good quality cassette recorder is recommended, preferably one with 
Jack-type MIC and EAR sockets. A tape counter is also very useful when 
locating programs on cassette. The authors have found a Hitachi TRO-299 
to be very suitable. The twin lead supplied connects the MIC and EAR 
sockets on the 7Х80 to the corresponding sockets on the recorder, Бу 
two standard 3.5 mm jack plugs at each end. A recorder with DIN con- 
nections may be used but this necessitates obtaining a different lead (from 
an electrical store such as Currys). Such a lead should have a twin cable 
and two 3.5 mm Jacks at the ZX80 end and a 5 pin DIN plug at the 
recorder end. It is a good idea to use a lead of about the same length as 
the one supplied. Overall, jack connections were found to be more 
reliable than DIN connections. 
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Figure 1 — ZX80 system layout 
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Power Supply 


The power socket of the ZX80 accepts 7—11 V DC with a current of 
about 400 mA, again connected by a 3.5 mm jack, with positive tip. It 
is safest to use the supply provided by Sinclair, but providing one's own 
supply meets the above requirements all should be well. One may find 
that the thermal fuse in the Sinclair power supply blows if the unit is left 
on for more than about eight hours. 


Switching On 


Having received an assembled ZX80, one may check it for the first time 
as follows: connect the power supply to the POWER socket, and the 
VIDEO lead as described above and switch on. Tune the television to 

36 UHF until the grey dashes on the screen turn to a uniform white and 

a K (the cursor) is shown at the bottom left-hand corner of the screen. 

If this does not happen and the television is correctly tuned then either 
the power supply or the ZX80 itself is faulty. Providing this test is passed 
the ZX80 may be further checked by loading a program from cassette 
and running it, as now described. 


1.3 LOADING PROGRAMS FROM CASSETTE 


Pre-recorded programs for the ZX80 are readily obtainable from LINSAC 
and are an ideal way for the beginner to learn to use the computer. The 
following procedure should be followed for loading programs from 
cassette into the ZX80's memory: 


(i) Insert the cassette into the recorder and REWIND to the 
start. 


(1) With the EAR plug disconnected, press PLAY on the 
cassette. 


(11) A loud buzz will be heard, followed by a silence and then а 
high-pitched buzz (the program) — stop the cassette at the 
beginning of the silence. 


(м) | Setvolume and tone controls on the recorder to maximum. 
If there are separate BASS and TREBLE controls, set BASS 
to minimum and TREBLE to maximum. Connect the EAR 
Jack but not the MIC jack. 
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(v) X Connect Ше power supply to the ZX80 and with the aerial 
socket connected a K will be shown as described above. 


(vi) Press the W key (load), then the NEWLINE key and immed- 
iately press play on the recorder. 


(vii) When a number of lines of text are displayed on the screen 
(after no more than 60 seconds of playing), stop the recorder. 
The program has now been loaded. 


If the program does not load, reset the ZX80 by removing and re-inserting 
the power lead and repeat the above process. |f no success is obtained, 
the cassette heads may be at fault — clean and, if possible, demagnetise 
them. A low-quality recorder often gives poor results. Problems may 
often occur if the ZX80 has become hot — allow it to cool and then try 
again. 


1.4 ENTERING PROGRAMS FROM LISTINGS 


2 X80 program listings are even more readily available than cassette soft- 
ware: programs may be found in the ZX80 operating manual, in chapter 
six of this volume, in hobbyist magazines, or again from the LINSAC 
catalogue. 


To the novice a program listing may look very baffling — it helps however 
to recognise that a program consists of instructions numbered in the order 
in which the ZX80 is to follow them. Thus a listing is a collection of 
numbered lines. Lines are entered by pressing the keyboard keys, and 
each line is terminated by NEWLINE. However it is not necessary to 

type in an entire listing letter-by-letter, since certain frequently occurring 
words (BASIC keywords) have their own keys, e.g. PRINT is entered by 
pressing the O key, rather than P-R-I-N-T. Such single-key entries may 

be identified in the listings in Chapter six. 


Before starting to enter a new program from a listing press the NEW key 
(Q) and NEWLINE : this prepares the ZX80 to store a new program. As 
you enter the first line, what you type will appear at the bottom of the 
TV screen. When NEWLINE is pressed at the end of the line, the line 
moves to the top of the screen. As further lines are entered, these too 
move up the screen. ІТ several lines are entered the initial ones may dis- 


appear from the screen: they are still held in the computer however. If at 
‚ 10 


апу stage an S appears, in inverse form, on a line, or If you notice that 
NEWLINE has no effect, then an error has been made іп entering the 
line. The S shows the position of the mistake: press the RUBOUT (shift 
O) key repeatedly until the S diseppears, and re-enter. 


Te 5 о a ею, ond «di 
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1.5 RUNNING PROGRAMS 


iwi 
Pre-packaged software generally comes мкг” Instructions, апа these 
should be followed. 


Modes 


The ZX80 operates in two modes, command mode and program mode. 
When a program has been loaded from cassette the program instructions 
will be shown оп the screen. Program mode 15 entered by pressing RUN, 
the listing disappears, and the machine remains in this mode while the 
program is running. ІТ at any point in the running of a program the 
listing appears on the screen it is clear that the program has terminated 
for some reason. 


Input 


The computer works conversationally, that is, in most programs the user 
enters information from the keyboard and the computer replies by dis- 
playing further information on the screen. Note that while the computer 
15 processing, the screen goes blank. 


In using a program one may need to enter two types of data, either 
numbers or text. If the program expects numbers the cursor will appear 
as an inverse video L, while if text is expected the | will have quotation 
marks around it. Every input must be terminated by pressing NEWLINE. 


If an error is made in entering information (e.g. entry of a number out- 
side of the permitted range — 32768 to 32767) an inverse S will appear on 
the screen and the NEWLINE key will have no effect. To overcome this, 
the error must be corrected. This may be done most simply by rubbing 
out the wrong input and then entering correct information: hold down 
the shift key and press RUBOUT (number O) repeatedly until the error is 
removed and then input the data correctly, ending with NEWLINE. 
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Rerunning 


When the program ends, a numerical code will appear at the bottom left- 
hand corner of the screen, e.g. 0/500. If the number before the / is other 
than O or 9 then the program has ended prematurely with an error: this 
of course should not happen with a well-produced prepackaged program. 
To run a program again, first press any key (this causes the ZX80 to 
revert to command mode, and the program instructions will appear on 
the screen) then press RUN and NEWLINE, and the program starts 

again. 


Some programs may require the use of the CONT (continue) key after a 
program has stopped. This simply causes the program to be restarted 
from where it stopped: often used in two-player quiz programs where 
one players sets up information for the quiz and then the other player is 
tested. 


Interrupting 


A final comment concerns how to stop a program that is running, for 
example if one realises that inappropriate data has been input. The 
BREAK key (shiftand’space) may work while the program 15 being 
processed (blank screen). Otherwise one may stop the program while it 
is waiting for input by entering data which will cause a program error. 
It will become clearer why this works later, but at present follow the 
following rules. 


1. For number input enter 999*99 and NEWLINE. 


2. For text input: 


(а) press shift-8 and then RUBOUT twice (This removes 
the quotes) 


(b) then enter CHR$ (999*99) 
In both cases the program terminates with a code 6/. 


If one wishes to stop a program and one 15 unconcerned that it will be 
lost from the ZX80's memory, then the simplest method is to disconnect 
and then reconnect the power jack. 


12 


CHAPTER TWO - ТНЕОКУ ОҒ COMPUTERS 


2.1 INTRODUCTION 
Before launching into programming а computer it is useful to know 
something of the structure of a computer system and of what is happen- 


ing when a program 15 running. This chapter summarizes the main parts 
of a computer and outlines how computer programs may be developed. 


2.2 ELEMENTS OF THE COMPUTER 


Summary 


PROCESSOR 


INPUT OUTPUT 
DEVICE DEVICE 


MAIN MEMORY ` 


SECONDARY 


MEMORY 
DEVICE 


Figure 2 — Computer structure 
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When we handle information we often do so in three distinct stages — 
reading, processing and writing. For example, in doing a crossword 
puzzle we read a clue, work out the answer, and then write it down. 
T his also applies to computer processing of information, and there are 
devices corresponding to the human facilities enabling us to read, process 
and write. Information is entered via an input device to the central 
processing unit (CPU) where it is processed and results sent to an output 
device. A large part of the CPU is memory, but this may be supple- 
mented by an exterior secondary memory device. These devices appear 
in the ZX80 as follows:— 


ELEMENT ZX80 FEATURE FUNCTION 
Input device Touch sensitive keyboard. Entry of data to CPU. 


Output device | TV Screen Display of results of 
processing 


Processor 180-1 microprocessor Processing of data 


Main memory ROMand RAM components Storage of program 
| instructions and data 
currently in use 


Secondary Cassette recorder Storage of programs on 
Memory device long-term basis 


T hese features are now considered in detail. 


Input 


Each time a key on the keyboard is depressed an appropriate numerical 
code is stored in an area of main memory. 


Output 


Results of processing are displayed on the television screen by means of 
24 lines of 32 characters each. 


Processor 


The 780-1 microprocessor can be considered the 'heart', or perhaps more 
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appropriately the 'brain', of the ZX80 computer. In conjunction with 
main memory it follows the instructions of a computer program using 
data supplied. Its three main parts are: 


(1) The control unit — controlling the step-by-step execution 
Of a set of program instructions. 


(i) Тһе arithmetic and logic unit — carrying out arithmetic 
and handling decisions. 


(ІІ) Registers — a very small amount of memory used as the 
processor's 'scratch-pad'. 


Main Memory 


Some understanding of memory principles is vital to successful computer 
programming; this will be considered in more detail. 


Main memory at the lowest level consists of groups of two-state devices, 
e.g. devices which can have high potential ог low potential. ІТ one state 
15 represented by the digit O and the other by the digit 1 we have a direct 
link with the binary number system. Such devices in the ZX80's mem- 
ory are grouped in 8's so that one memory 'slot' or location can hold 
eight binary digits (O's or 1's). The term binary digit is often abbreviated 
to ‘bit’ and a group of eight bits is referred to as a ‘byte’. 


A given memory location or byte could therefore contain the pattern 
0001 0110. To understand what this means, consider a decimal number, 
e.g. 234 or (2 x 10?) + (3 x 101) + (4 x 109), using powers of ten based 
upon the position of the digits in the number. Similarly in binary 0001 
0110 means (1 x 22) + (1x2?) + (1x2') or 16* 4+ 2 = 22. Thusa 
byte may contain anything from 0000 0000 to 1111 1111 or O to 255. 


Numbers are stored in two bytes with the least significant eight bits in 
the first byte and the most significant eight bits in the second byte, as 
usual with the Z80 processor. 


Positive numbers are stored with a zero in the most significant bit posi- 
tion, thus giving a range of: 


0000 0000 0000 0000 to 0111 1111 1111 1111 
orO to 32767 


Negative numbers аге held in “two's complement'' form i.e., a number 
-N is stored as (212 —N). This means that negative numbers always have 
a one In the most significant bit position. To avoid long series of zeros 
and ones, the hexadecimal number system (base 16) is commonly used 
as shorthand for binary. This system has digits representing numbers of 
powers of sixteen and uses the characters 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 

A, B, C, D, E, F, the letters representing decimal 10, 11, 12, 13, 14, and 
15 respectively. 


Thus a hexadecimal number ЗЕ is 3 x 161 + E x 16? 
=(3 x 16) + (14 x 1) 


= 62 
In binary, 62= 0011 1110 
= but 0011 = 3 
and 1110 = 14 = E hexadecimal 


Therefore a binary number may be represented simply in hexadecimal 
by one hexadecimal digit replacing four binary digits. 


Turning to what тау be stored in memory, It Is appropriate to return to 
a human analogy. If we wish to work out a problem we need two differ- 
ent types of information, e.g. in calculating the amount of carpet re- 
quired to cover the floor of a room we need to know: 


(i) the dimensions of the room, and 
(ii) how to do the calculations, i.e. length x breadth. 


Similarly for a computer to solve a problem, it needs to have in its 
memory both the data required and instructions to follow. Thus the 
number in a byte may either (partly) represent an item of data or a 
program instruction. 


Secondary Memory 


On many computers secondary memory is used to supplement the size 
of the main memory in the running of a program, in order to increase the 
amount of data that may be used. At the time of writing such data files 
on secondary memory are not available on the Sinclair ZX80. However, 
its other main use 15 the semi-permanent storage of programs for later re- 
loading. A number of instructions comprising a program may be entered 
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into main memory ма the keyboard. However, when the machine 15 
switched off, memory contents are lost. To avoid having to re-type the 
program whenever it Is required, it may be transferred from main mem- 
ory onto a cassette by a simple command, and then transferred back 
again at a later time. The format іп which programs are stored оп 
cassette is unique to the ZX80 and is not compatible with that of other 
computers. 


23 DEVELOPMENT OF PROGRAMS 


Languages 


A computer program 15 а group of Instructions written in a programming 
language. The computer actually obeys instructions in binary-machine 
code which 15 orientated towards the architecture of the computer. The 
Z X80 uses the machine code of the Z80 microprocessor. This is dis- 
cussed further in Chapter Three Section 7. Programming languages 
nearer to English have been designed to make programming easier, and 
ZX80 BASIC 15 an example of such a “high level'' language. As in any 
language, BASIC has grammatical rules which must be followed in order 
for instructions to make sense. 


Тһе ZX80 has an ''interpreter'" program permanently resident іп mem- 
ory, which translates a BASIC program into binary machine code to be 
executed by the computer. The art of BASIC programming consists of 
learning the grammatical rules of BASIC but also, perhaps more important, 
learning correct methods of programming. These are now discussed by 
considering the step-by-step development of a single program. 


Describing the Problem 


Programs are designed to solve problems, either useful problems such as 
sorting items into sequence, or more leisurely applications such as games. 
However, it is vital to fully describe the problem before considering how 
to solve it. Such a description should include details of what 15 to be 
input and what is to be output: in fact it is sometimes useful to write 
down exactly what you expect to appear on the output screen. Consider 
a simple number guessing game, in which a player attempts to guess a 
number chosen by the computer. A full description may appear as 
follows: 
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Instructions оп playing the game аге given оп the screen. 
The player then has ten goes at guessing a number between 
1 and 100 chosen by the computer. After each guess the 
player Is told whether the guess Is too high, too low or 
correct. If correct the game ends, otherwise the player Is 
Invited to guess again. After ten incorrect guesses the 
number Is revealed and the game ends. 


Defining the Method 


The next stage is to design the method by which the program will solve 
the problem. Such methods are best learnt initially by studying other 
people's programs ог by reading texts on the theory of algorithms. 
However, there are certain general considerations which may be followed. 
It is best to consider the method in separate parts or ''modules'', each 
being relatively independent of the rest. The modules may then be 
developed and tested separately, making life much easier, particularly in 
detecting any program errors. The modules may be written down in a 
block chart form or a series of discrete steps. In a large program 
modules may be themselves broken down into sub-modules. Returning 
to the number game example we use the following method. 


1. INSTRUCTIONS — display instructions 


2. CHOOSE NUMBER — choose random number R (1—100) 


3. LOOP — 10 times 
(i) — invite guess and input as G 
(i) — COMPARISON — compare G with R and print 


appropriate message 
(e.g. too low). If G = R then 
stop. 


4. SHOW NUMBER — display value of R 


Note that letters may be used to refer to items of data at this stage. 
Some programmers like to use ''flowcharts'' — visual representations of a 
program method incorporating different shaped boxes linked by flow- 
lines. Examples may be found in most books on programming. For 
example, as part of the method detailed above we have: 
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INVITE 
& 
INPUT GUESS 


COMPARE 
GUESS: 
NUMBER 


PRINT 
"TOO LOW" 


PRINT 
"CORRECT" 


PRINT 
“ТОО HIGH” 


Figure 3 — Flowcharting example 


For the ZX80 with only 1K of user memory a large consideration in 
designing a program method is to the economical use of storage space. 
This often necessitates keeping printed text, such as instructions, to a 
minimum. It also means using efficient techniques of coding programs. 
These are considered in Chapter Three. 


Coding the Program 


The grammatical rules of BASIC are summarized in Section 3.1. However 
the number game might be written down and then entered as: 


10 PRINT, "NUMBER GAME" 


20 PRINT “YOU GUESS A NUMBER” 
19 


2.0 PRatT “ое 

4o LET К=КаР (ое) 

50 FOR |= 1 ТО 10 

60 PRINT "GUESS МО. "7":1;7" 7, 
70 INPUT G 

80 IF G«R THEN GO TO 120 
90 IF С> R THEN GO ТО 140 
100 PRINT G; “IS CORRECT” 
110 STOP 

120 PRINT G; “IS TOO LOW" 
130 GO TO 150 

140 PRINT G; "IS TOO HIGH" 
150 NEXT I 

160 PRINT "HARD LUCK — IT WAS '*R 


While coding the program make a list of the letters (symbolic names) 
used to represent data, e.g. 


R = number chosen at random 
| = counter showing sequence number of guess 
G = guessof player 


This is to ensure that symbols are not used twice and to provide an aid to 
understanding the program at a later date. 


Testing and Debugging 


Often a program, once coded and run, does not run correctly first time 
and even if it does, this does not necessarily mean it is correct. А pro- 
gram should be tested as thoroughly as possible with varying test data 
bearing in mind likely users of the program. "Debugging" is the detec- 
tion of program errors or “bugs” and their correction. Syntax ог 
grammatical errors are normally detected by the system in the entering of 
program instructions: an S cursor indicator shows this (see Chapter 
Three). 


However, errors may also occur in the running of a program and cause it 
to terminate with an error code. Тһе meaning of this code 15 determined 
from the ZX80 Operating Manual and the cause of the error then sought. 
If difficulty is encountered, extra output statements should be included 
in the program to both show the flow of the program and also inter- 
mediate values of symbols used. Modular programming facilitates 
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debugging. 


Documentation 


Having produced a working program, even ІТ only for one's own use, it Is 
very worthwhile to document it: This involves two or three pages of 
notes — a collection of the notes made in developing the program. 
Sections to include are description, method, list of variables, program 
listing, a sample program run and, If someone else will use the program, 
instructions for use. A documentation file is very useful If one wishes 
to return to a program some weeks after writing it, or if others wish to 
use the program: it Is amazing how quickly details are forgotten. 


Samples of LINSAC documentation appear in Chapter Six. 
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CHAPTER THREE - 2Х80 BASIC 


The following summary of ZX80 BASIC is intended for readers familiar 
with BASIC. Other users should start at section 3.2, having briefly 
viewed the summary. 


3.1 SUMMARY 


Lines 


ZX80 BASIC has a line-orientated structure, with one program instruc- 
tion per line. Lines are numbered (maximum of 9999) in the order in 
which they are to be executed. In command mode the current program 
listing or part of it is displayed in the upper screen while the instruction 
being entered is shown at the bottom working area. Intermediate lines 
may be entered by choosing appropriate intermediate line numbers. A 
line may be deleted by entering the line number only. A line may be 
edited by using the cursor control keys (arrows) to move the current line 
number pointer (inverse >) to the line and then pressing EDIT. This 
causes the line to appear іп the lower working area where it may then Бе 
altered, again using cursor control keys, RUBOUT, or insertions as 
required. 


The Display File 


The concept of the ‘display file’ 15 a crucial one in understanding the 
workings of ZX80 BASIC. It consists of an area of RAM holding the 
characters that are ‘currently’ being shown on the screen. The size of the 
display file varies according to how much information 15 on the screen. 
Its size is limited by the amount of other information In RAM, and in 
particular the size of the current program and accompanying data. Thus 
if a large program 15 entered the display file shrinks: less and less lines 
are displayed on the screen. Similarly when a program is run, the pro- 
gram may terminate having produced more output than can be held in 
the display file, although only half of the screen may be taken up. 
Further details on the display file appear in Chapter Б. 
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Symbols 


Memory locations or variables are referred to by symbolic names, with 

rules on name formation depending on whether numbers or characters 

are stored. Numerical names may be of any length composed of letters 
and numbers but must start with a letter. Character names consist of a 
letter followed by a dollar sign. 


Keywords 


ZX80 BASIC is based upon the use of keywords which make up the 
commands and program instructions used. Most of these тау be entered 
by single key-strokes. A “command” is entered without a line number 
and 15 obeyed by the computer directiy, whereas a program instruction 
requires a number and is only obeyed when the program 15 гип. 


Cursor 


The cursor is used in command mode to indicate whether a keyword (K) 
or literal (L) is to be entered next. For example if key U is pressed when 
the cursor is 'K' then IF will be displayed: If however the cursor shows 
"L' then simply the letter U will be shown. If an error is made in entering 
a program line an inverse S will be shown at the point of error and the 
newline key will not be accepted until the fault has been rectified 

using editing facilities. 


Commands 


The following keywords are normal commands but can (not very use- 
fully) be used as program instructions if preceded by a line number. 
Brackets refer to an optional feature. 


LOAD - transfers a complete program (+ data and system variables) 
from cassette into main memory. 


SAVE - reverse of LOAD. 


LIST (n) — lists program instructions, either from the start if integer 

expression n is omitted, or including line n if included, with the current 

line pointer (>) at this line (useful previous to editing). The amount of 
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the current program displayed іп command mode ог іп response to LIST 
depends upon the size of the display file. As stated above, the size of 
the display file depends upon how much RAM 15 Бета used for the 
current program and variables. If a program uses a large number of 
variables a larger program listing may be obtained by entering CLEAR 
(see below) beforehand. 


RUN (n) — clears variables and starts program executing at start of line 
n if specified. GOTO (n) has a similar effect, except that variables are 
not cleared — enabling a program just loaded to be restarted from its 
state as stored. 


NEW — initialises the system: all program instructions and variables аге 
erased. 


CLEAR - erases all variables, but retains current program. 


CONTINUE — used to restart a program from where it stopped. 


Instructions 


The following keywords are program instructions but most may be used 
without line numbers as direct system commands. 


LET name - expression stores the result of the expression in 
locations referred to by ‘name’. 


INPUT name stores a value input from the keyboard in 
locations referred to by ‘name’. 


PRINT list of variables displays values on upper screen. Lists 
Or expressions may be separated by commas ог semi- 
colons giving different output spacing. 


GOTO n where n is a numerical expression. Causes 
program execution to continue at line 
number n or the next line with a number 
higher than n if line n is not present. 
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IF condition — 
ТНЕМ instruction 


ОІМ letter (n) 


GOSUB n 


RETURN 
CLS 


REM 


RANDOMISE n 


POKE n1, n2 


if the ‘condition’ 1$ not false then the 
‘instruction’ is obeyed. Otherwise по 
effect. Conditions can contain relational 
operators >, < and = and connectors 
AND, OR, NOT. 


allocates memory space for an array with 
a highest subscript given by the expression 
n. It 15 referred to by the letter. Only 
опе dimension 15 allowed. 


Transfers program control to a closed sub- 
routine at a line number given by 
numerical expression n. Control is re- 
turned to the instruction following 
GOSUB when RETURN is encountered. 


return from subroutine. 
clears the screen. 


a comment statement which тау Бе 
followed by any symbols: there 15 по 
effect on the program. 


sets the initial value of the random 
number generator to n If specified or 
otherwise to a value based on the TV 
frame counter. 


places the value of numerical expression 
n2 in memory location n1. 


Functions 


The following functions may be used in instructions:— 


RND (n) 


gives a (pseudo—) random number 
between 1 and n. 
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ABS (n) gives the absolute (unsigned) value of ex- 


pression n. 

PEEK (n) gives the decimal contents of memory 
location n. 

USR (n) causes entry of a machine code routine at 


address n and on returning, supplies the 
value left in the HL register pair, or n if 
HL is unchanged. 


The remaining functions concern character strings. 


TL$ (string) supplies a string identical to its argument 
without its first character. 


CODE (string) supplies the numerical code of the first 
character of the string. 


CHRS$ (n) supplies a character, the code of which is 
the value of expression n. | 


STR$ (n) supplies a character string equivalent tc 
| the маце of expression п. 


Operators 


Expressions may Include the operators — 


+ (addition), — (subtraction), * (multiplication), / (division), 
** (exponentiation), AND, OR, NOT (logical), > (greater than), 
< (less than), = (equal) 


The experienced BASIC programmer may now study the programs in 
Chapter Six to see typical uses of ZX80 BASIC and proceed with his 
own programming. Less informed readers are recommended to study the 
following more detailed treatment of BASIC, which also includes more 
advanced features emphasised by a line in the left hand margin. 
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32 ASSIGNMENTS AND CALCULATIONS 


This section covers the use of the LET statement for numerical expres- 
sions and related. operators and functions. 


Symbolic Names 


As stated in Section 3.1, memory locations containing numbers may be 
represented by names starting with a letter and consisting of numbers 
and letters, e.g. V, V1, RESULT, SUB2TOTAL. Such variable names 
may be of any length, but it is advisable to keep them as short as 
possible to economise on memory: they are stored as follows: 


(i) Single character variable 
NAME VALUE 
(1) Multicharacter variable 
при ШЕ [ T u | w | 
NAME VALUE 


N.B. The first byte of the name has its third bit set to zero and the last 
byte of the name has 115 first bit set to one, as mark bits. 
Expressions 
The general form of the LET statement for numerical variables 15 


line number LET name = numerical expression 


A numerical expression consists of variable names or numbers, perhaps 
linked by operators (see 3.1), similar to a mathematical formula 


eg. LET P-B* С/О — 18 
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Brackets тау also Бе Included 


eg. LET M=(A+B+C)/3 


Operators must be explicit rather than implied. For example the formula 
у = ах? + бх + с 
would be represented as 


LET У=А*Х **2 + В*Х+С 


It is quite valid to have the same variable on both sides of the equal sign. 
For example to add 1 to the value of K we have 


LET К-К + 1 


The operators іп an expression аге evaluated in the following order: 


(i) exponentiation (* *) 

(ii) negation (eg —A) 

(iii) multiplication (*) 

(iv) division (/) 

(v) addition (+) and subtraction (—) 


Expressions inside brackets are evaluated first in the order above. The 
reader may wish to experiment to see the effect of this operator priority. 
For example the following program may be entered 


10 LET A = 6 + 30/2 * 3 

20 LET B = (6+30)/2*3 
30 PRINT “А-”:А 

40 PRINT “В-”:В 


Logical Values 


Relational expressions may also be used in LET statements, since a'true ' 
value is held in memory as all ones i.e. —1, and a ‘false’ value as all 


zeroes, i.e. (. 
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Рог example - 


LET M= —10 * (A=B) -20%(А>В) + 10“ (А<В) 
This sets M to 10 if A is equal to B, to 20 НА is greater than В and to 
—10 if A is less than B. 


The logical connectors AND, OR and NOT can be used in a similar way. 
They obey the rules shown below, taking X as a numerical variable 


AND: True AND X gives X 
False AND X gives false 


OR: True OR X gives true 
False OR X gives X 


NOT: МОТ X gives —X —1 


T he power of these operators becomes clearer if we consider what 
happens in memory. 


Consider X equal to 2595 and Y equal to 15, i.e. 


0000 1010 0010 001 1 X 


0000 0000 0000 111 1 Y 


If we have the statement LET A - X AND Y then using the rules above 
A 15 


0000 0000 0000 001 1 A 


or 3. That is, all but the lowest four bits of X have been masked out. 
The uses of this may not seem immediately obvious but the following 
decimal — to — hexadecimal conversion routine illustrates the point. ІТ 
D is a positive decimal number, it may be converted to a hexadecimal 
number of four digits, H1, H2, H3, H4 as follows: 


100 LET H1 = (D AND 28672) / 4096 
30 


110 LET H2 = (D AND 3840) / 256 
120 LET H3 = (D AND 240) / 16 


130 LET H4 = D AND 15 


The number could be printed by the following (see Section 3.6) 


140 PRINT CHR$ (H1 + 28); CHR$ (H2 + 28); CHR$ (H3 + 28); 
CHR$ (H4 + 28) 


The above routine uses “та5К5” of 


28672 which is0111 0000 0000 0000 binary 

3840 which is 0000 1111 0000 0000 binary 

240 which is 0000 0000 1111 0000 binary 

and 15 which is 0000 0000 0000 1111 binary 


and the numbers 4096, 256 and 16 are used to reduce the resulting 
numbers to within the hexadecimal digit range 0 to 15. 


NOTE: Care should be exercised in using relational and logical operators 
as these are evaluated in priority sequence as are arithmetic 
operators — see ZX80 Operating Manual, Appendix ll. 


Functions 


There are two numerical functions in ZX80 BASIC, RND and ABS. 
RND тау be used in conjunction with RANDOMISE, which initialises 
the sequence of random numbers generated by RND. 


The general form of the RND function Is 
RND (numerical expression) 


If the value V of the expression is positive then we get a random number 
between 1 and V; If it Is negative we get a random number between 

V—1 and —32768, or 1 to 32767; if it is zero we get the number 1. 
Random numbers are useful in many games programs requiring an ele- 
ment of chance. For example to get a random number R representing 
the code ofan alphabetic character (see Section 3.6) i.e. between 38 and 
63, we have — LET R = 37 + RND (26) — and the character could be 


printed by: " 


PRINT CHR$ (В) 


Тһе ABS function gives Ше positive (modulus) value of ап expression. 


Integer Arithmetic 
The apparent disadvantage of ZX80 BASIC that only whole numbers are 
allowed can be useful in some circumstances. Any expressions that 
would normally evaluate to a number involving a fractional part are 
truncated to the next lowest Integer. 


For example — LET N = 13/5 — gives N equalling 2. 


Thus to find whether a number А 15 divisible by another number, say 2, 
we may have, e.g. 


IF A = (А/2) * 2 THEN PRINT "EVEN" 


3.3 INPUT AND OUTPUT 


The INPUT Instruction 


There is only one Instruction for entering data into ZX80 programs, the 
| МРОТ statement. Its form is 


line number INPUT variable name 
Its effect is to print the cursor at the start of a line on the screen, either 
enclosed by quotes if characters are required, or alone if a number is 


required. Data entered іп response to INPUT 15 not automatically 
printed on the screen. 


The PRINT Instruction 


The output statement has the form 
line number PRINT list of variables, numbers or text. 
The list elements may be separated by commas or semicolons, the 


former causing alignment at the 9th, 17th or 25th positions on a line, 
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апа Ше latter causing elements to Бе printed immediately after each 
other. 


e.g. PRINT 1, "VALUE OF B=” A * 6 
assuming А has a value of 12 produces 


1 VALUE OF B=72 


Anything inside inverted commas 15 printed exactly, whereas items out- 
side are evaluated and then printed. Each PRINT statement produces 
output on a new line, unless the previous output statement ended with а 
comma or semicolon. 


e.g. 10 PRINT “MAXIMUM VALUE =”; 
20 INPUT M 
30 PRINT M 


If the value 26 is entered when prompted, this produces 
MAXIMUM VALUE = 26 


PRINT may also be used as a command 1.е. without a line number. This 15 
useful when a program has terminated abnormally, since values of 
variables at the point of termination may be printed out. 


It is sometimes helpful to print out information in inverse form (white 
on black) to highlight certain items. Methods of doing this are outlined 
in Section 3.6. 


3.4 CONDITIONAL AND UNCONDITIONAL JUMPS AND LOOPS 


Routines 


Program instructions are normally obeyed in line number sequence. 
However sometimes transfer of control to another part of the program 
is required, particularly if the program has been written in modules (see 
Chapter 2). Transfer to an open routine is achieved by the GO TO 
statement while transfer to a closed routine requiring a return to the 
original position afterwards 15 done using the GO SUB statement. А 
closed routine or sub-routine is used when a module 15 to be used several 
times at different points in the program. It terminates witha RETURN 
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statement which sends control back То the statement following the 
original GO SUB. The transfer of control may be made cond itional 
through the use of the IF statement. 


The GO TO Instruction 


Consider first the GO TO statement. Its general form is 
line number GO TO numerical expression 


and it has the effect of sending control to the line with a value equal to 
or (if no such line exists) greater than that of the numerical expression. 
Execution then continues normally from that line. |t is known asan un- 
conditional jump. Simple example: | 


10 PRINT “HELLO” 
20 GO TO 10 


This prints the word HELLO successively on the screen until it is full and 
an error occurs. 


More complete example: 


10 PRINT "ENTER 1-4” 
20 INPUT N 

30 GO TO N * 100 

100 PRINT “GENESIS” 
110 STOP 

200 PRINT "EXODUS" 
210 STOP. 

300 PRINT "LEVITICUS" 
310 STOP 

400 PRINT “NUMBERS” 


This prints GENESIS if 1 is entered, EXODUS if 2 is entered and so оп 
up to 4. When using such expressions in the GO TO statement, care 
should be taken То avoid out of range values: this may be done using the 
IF statement as will be seen later. 


GO TO may be used as a command (without a line number) to start off 
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а program at а point while preserving values of stored variables. This is 
particularly handy after LOADing a program from cassette since values 
of program and system variables are stored on cassette as well. In fact, 
once a program has been developed space may be saved by setting up all 
initial data values (by INPUT or LET instructions) at the start of the 
program, then stopping, erasing the appropriate INPUT or LET state- 
ments and then storing the program on cassette (using SAVE). When 
required the program is LOADed, and restarted by the GO TO command. 


The GO SUB instruction has a similar form to GO ТО: 
line number GO SUB numerical expression 


and has identical effect except that the computer also stores the number 
of the line following it, so that it may be returned to afterwards. It is 
known as an unconditional sub-routine jump. The single word instruc- 
tion RETURN terminates the routine jumped to. 


Example of the use of these statements: 


150 GOSUB 500 
160 ® ° e 


500 PRINT “PRESS NEWLINE TO CLEAR SCREEN” 
510 INPUT Z$ 

520 CLS 

530 RETURN 


The instruction at line 150 Invokes lines 500-530 and then control 15 
returned to line 160. 


The IF Instruction 
The conditional IF instruction has the form: 
line number IF condition THEN instruction 


and the instruction part is executed unless the condition is false (or O, 
see Section 3.2). The condition part may be made up of the conditional 
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operators and conjunctions mentioned previously, i.e. 
>,<, =, AND, OR, NOT 


and the instruction part may be any valid instruction, including another 
IF statement: the most commonly used instruction is GO TO. For 
example a simple input checking statement is shown below at line 30. 


10 PRINT "ENTER 1—4" 

20 INPUT N 

ЗО IF N<1 OR N24 THEN GO TO 20 
40 PRINT М 


A short program to find the largest of list of numbers (ending with zero) 
uses the IF statement as shown: 


ТО LET M = —999 

20 PRINT "ENTER NUMBER OR 0 TO STOP" 
30 INPUT N | 
40 IF М= О THEN GO TO 70 

БО IF N>M THEN LET M =N 

60 GO ТО 20 

70 PRINT "LARGEST NUMBER WAS ”;M 


Use of the IF statement may be extended to repeat a section of a pro- 
gram a number of times (a loop). The example prints a table of squares 
of numbers up to ten. 


10 PRINT , "NUMBER", "SQUARE" 
201ЕТ № = 1 

30 PRINT ,N,N * N 

40 |ЕТМ-М + 1 

50 IF М> 10 ТНЕМ STOP 

60 СО ТО 30 


Неге М 15 being used as а counter as well as дата. 
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Тһе FOR Instruction 


Loops may be implemented in a simpler way using two statements in 
conjunction — the FOR and NEXT statements. These have the form: 


line number FOR letter = start expression TO end expression 
° • • (section of code to be repeated) 
line number NEXT letter 


For example 


10 FOR C= 1 TO 10 
20 PRINT "MESSAGE" 
30 NEXT C 


displays MESSAGE ten times. Thus the above NEXT statement is 
equivalent to 


30 LET С= С + 1 
40 IF МОТ С > 10 ТНЕМ GO ТО 20 


Thus at the end of the loop the counter has а value опе greater than the 
end value specified in the FOR statement. Note also that the counter is 
incremented by one each time — if a different increment is required then 
LET and IF statements must be used to specify the loop. 


Further uses of loops appear in the following section. 


3.5 ARRAYS 
Definition 


An array is a group of numbers referred to by a single letter, with indi- 
vidual numbers in the group identified by numbered subscripts. For 
example, if A refers to the numbers 1, 6, 4, 2 then A (0) is 1, A(1) is 6, 
A (2) is 4 and A (3) is 2. 


It is stored in memory thus 


I Tas us 
letter max first ии last 
(bit1=1) subscript number number 
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Тһе DIM Instruction. 


Before an array may be used in a program its size or dimension must be 
defined using the DIM statement, of the form 


line number DIM letter (highest subscript) 


Subscripts are numbered from zero, so an array DIM A (10) has a maxi- 
mum of eleven numbers in it. It is permissible to name an array by a 
letter identical to that used for another variable in a program, each 
remaining separate through the different storage formats. 


Arrays are often used in loops. The following program sets up an array 
of numbers, then puts them into numerical order using a simple sorting 
algorithm, and finally prints out the sequenced array. 


10 DIM A (9) 
20 FOR І-0 ТО 9 
30 PRINT "NUMBER "';I;" =”; 
40 INPUT А(І) 
50 PRIN TA(I) 
60 NEXT | | 
70 РОВ | = ОТО 8 
80 LET M = —999 
90 FOR J = | TO 9 
100 IF A ())<М THEN GO TO 130 
110 LET M = A(J) 
120 LET X = J 
130 NEXT J 
140 LET T = A(I) 
150 LET А(І) = A(X) 
_ 160 LET A(X) = T 
170 NEXT I 
180 PRINT "SORTED LIST" 
190 FOR | = ОТО 9 
200 PRINT А(!);”"; 


210 NEXT I 
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Arrays are often utilised in conjunction with character codes as Is now 
discussed. 


3.6 CHARACTER HANDLING 


Storage 


Thus far only numerical data has been considered, but many applications 
require the manipulation of letters or other symbols or even letters and 
numbers together. Any data that is not to be used mathematically may 
be stored in character format, that is, Бу means of a unique numerical 
code for each character. Groups of characters (i.e. numbers, letters or 
special symbols) are often referred to as strings. 


Character data is referred to by variable names of the form of a letter 
followed by a dollar sign, e.g. A$, C$, X$, and 15 stored in memory as 
shown below. | | 


letter first char BEND last char quote 
(+96) 


Тһе numerical codes representing characters аге shown in Appendix 1. 
For example the letter А is represented by the binary pattern 0010 
0110, i.e. decimal 38. Special picture or graphics characters can also be 
stored, and even inverse characters i.e. white characters on a black back- 
ground. The latter do not appear on the keyboard but are reasonably 
accessible as will be shown later. Note that the code for an inverse 
character 15 128 more than its normal equivalent — it has the first bit set 
to one. Because of the ZX80's unique keyword system there are also 
codes standing for complete BASIC keywords, as shown in Appendix 1. 


It should be noted that although a number may be stored in a string 
variable it is still impossible to do arithmetic with the variable. For 
example 


10 LET A$ = "20" 
20 PRINT A$ *5 


is incorrect, since 20 is stored as characters rather than in pure binary form. 
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Аз shown above, string variables тау Бе assigned values using the LE T 
statement, with the data Inside quotation marks. Asan alternative, 
INPUT Instructions may be used and these cause the cursor inviting 

Input to appear Inside quotation marks. If these quotes are inadvertently 
rubbed out using cursor control characters the input will not be accepted. 
Programs may be personalised through the use е of string variables repre- 
senting the user's name as follows: 


10 PRINT “WHAT IS YOUR NAME?” 
20 INPUT N$ 
ЗО PRINT “HOW ARE YOU, “;N$; 


otring manipulation is not limited to simple assignments or output. 
Relational operators (> and <) may be used with characters in the same 
way as with numbers, except that they refer to alphabetic order, or 
rather order of codes (effectively the same). 


10 PRINT “WORD1 =” 

20 INPUT A$ 

30 PRINT А$; “ WORD2 ="": 

40 INPUT B$ 

50 PRINT B$ 

60 IF A$<BS THEN PRINT А%;” COMES BEFORE ”; B$ 
70 IF A$>B$ THEN PRINT B$; ” COMES BEFORE ”; A$ 
80 IF A$ = B$ THEN PRINT “THE SAME” 


(Not good style!) 


Any code may be entered in the above program, in fact any combinations 
of symbols may be tried. The way in which the character codes are 
designed means that MAN is evaluated as less (or earlier in alphabetic 
sequence) than MANKIND. Unfortunately this seemingly powerful 
facility is limited by the fact that arrays of strings are not available in 
ZX80 BASIC — otherwise word sorting routines could be used in 
programs. 


Functions 


The full power of string handling is realised with the addition of string 
functions. ZX80 string functions are somewhat unusual but permit 
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most operations То Бе carried out. 


СНВ$ (numerical expression) gives the character whose code 15 the 
value of the numerical expression. 


CODE (string or string name) gives the code of the first character of the 
string. 


TL$ (string or string name) supplies a string identical to the one in 
brackets minus its first character. 


ST R$ (numerical expression) supplies the value of the expression in 
character form: up to five digits and leading minus sign if 
negative. 


An important concept in character handling is that of the empty or nul! 
string e.g. TL$ ("A"). If it was required to test Z$ to see whether it 
was empty we could use — 


IF 2$ = "THEN PRINT “EMPTY” 
ОГ IF CODE (Z$) = 1 THEN PRINT “EMPTY” 


although character code 1 is quotation mark it сап also be used to test 
for the null string because of the manner in which character variables are 
stored in memory. 


Тһе following program illustrates the use of null strings: 


10 LET А$ = "ANY STRING" 

20 GO SUB 500 

30 PRINT 

40 STOP 

500 IF A$ = ""THEN RETURN 

510 PRINT CHR$ (CODE (A$) * 128); 
520 LET A$ - Т1% (A$) 

530 GO TO 500 


The subroutine at line 500 onwards considers А% one character at a time 
and prints it in inverse video, using the fact that an inverse character has 
a code of 128 more than its normal equivalent. The T L$ function is 
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used То gradually си? down А% until it is empty, ат which point the 
routine exits.. 


Inverse video can be helpful іп emphasizing certain outputs т а program 
for example titles or errors. A technique is used in the spelling quiz 
program in Chapter Six to highlight where the student has spelt a word 
incorrectly. Another way of printing inverse characters without the 
necessity of a separate routine is shown in Section 3.7. 


Character strings often need to be held as separate character codes and 

arrays may be used for this purpose. The following program inputs a 

word, stores its component character codes in an array, and then prints 
It in reverse order. There is a limit of thirty characters. 


10 PRINT "ENTER WORD" 

20 INPUT W$ 

30 PRINT W$ 

40 DIM C(29) 

БО FOR I + ОТО 29 

60 LET C(I) = CODE (W$) 

70 LET W$ = T L$ (W$) 

ВО IF W$ = **** THEN GO TO 100 


90 NEXT | 

100 LET | = 29 

120 PRINT CHR$ (C(1)); 
130 LET 1 = 1-1 


140 IF 1» —1 THEN GO ТО 120 


Characters are displayed through the character generator at the end of 
the monitor (discussed further in Chapters Four and Five). The 
following program by Pat Crabb shows how a word may be displayed in 
large characters on the screen, in 4-character groups. 


100 DIM X (3) 

110 DIM T (7) 

120 GO SUB 1000 

130 LET А5 - “| AM THE ZX80" 


140 GO SUB 7/00 " 


150 СО SUB 800 

160 ІМРОТ B$ 

170 CLS 

180 СО ТО 140 

700 FOR | = ОТО 3 

710 LET X (1) = CODE (А5) 
720 LET A$ = TL$ (A$) 

730 NEXT | 

740 RETURN 

800 FOR N = 0 TO 7 

810 РОВ 1 = ОТО З 

820 LET O =РЕЕК (3584 + 8 * X (l) + N) 
830 СО SUB 900 

840 МЕХТ | 

850 МЕХТ № 

860 ВЕТУВМ 

900 FOR M + ОТО 7 

910 LET С = 1 + (Q<T(7—M)} 
920 LET Q =Q — G * T (7—M) 
930 PRINT CHR$ (128 *G); 
940 NEXT M 

_ 950 RETURN 

1000 FOR М = ОТО 7 

1010 LET Т(М) = 2**M 

1020 МЕХТ М 

1030 RETURN 


The 6 x 8 matrices of alphanumeric characters held in ROM location 
3584 onwards are displayed in enlarged form by testing the bit patterns 
(see Chapter Five). Character 128 (inverse blank) is used to display the 
character, but other possibilities which may be substituted for 128 at 
line 930 are Х (1) or (Х (1) + 128) — these produce interesting effects. 
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3.7 MACHINE CODE 


Introduction 


Once the user has mastered BASIC there are still many areas of the 
system which may be explored using the functions and instructions 
providing direct access to memory locations and machine language. As 
stated previously machine language or machine code 15 the language 
directly executed by the ZX80 processor — it does not require prior 
translation as does BASIC. Appendix 1 gives a list of the possible con- 
tents of a mernory byte (0-255) together with the Z80 language opera- 
tion which it represents. The instruction is written in a mnemonic 
form (e.g. LD means load) known as assembly language. The list covers 
only single byte instruction codes and is therefore not entirely compre- 
hensive. 


The operations discussed in this section are orientated towards the 
ZX90's internal design and particularly the architecture of its micro- 
processor. It is recommended that users intending to enter this area of 
programming should obtain information on the #80 microprocessor 
family: Rodnay Zacs “Programming the 280” is particularly recom- 
mended. | 


Instructions and Functions 


Two 2Х80 facilities exist to access bytes directly. The PEEK function 
followed by an expression representing an address in brackets gives the 
decimal contents of the specified location, e.g. 


LET C = PEEK (1024) 


sets C to the decimal contents of byte 1024. Conversely the POKE 
instruction puts data into a memory location and has a form of line 
number POKE exp1, exp2 — the first expression specifying the address 
and the second being the value to be inserted e.g. 


30 POKE 16384,6 


places 6 into byte 16384. 


The most powerful ZX80 low-level facility is the USR function. It is 
followed by a numerical expression in brackets and this expression 
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provides ап address value То which control 15 transferred. Тһе resulting 
value of the USR function Is whatever the routine leaves in the register 
pair HL, or If HL is unchanged the original address value Is given, e.g. 


20 LET X = USR (16427) 


with location 16427 containing hex. 21 
16428 ü " 00 (LD HL, 0100Н) 
16429 ” " . 01 
16430  " " . C9 (RET) 


causes the value 256 (0100 hexadecimal) to be placed in X. 


T ypical uses of PEEK, POKE and USR are now considered. 


Systems Variables 


The monitor and BASIC interpreter of the ZX80 is held in read-only 
memory (ROM) but requires a certain amount of working space in 
random access memory (RAM). Such "system variables" held in this 
area may often usefully be accessed by programs — details may be found 
in Appendix ||| of the ZX80 Operating Manual. Figure 4 on the next 
page shows some of these variables. 


Most systems variables, in the same way as BASIC numerical values, are 
stored in a pair of consecutive bytes, the least significant byte first. As 
an example the pointer to the start of the display file, held in bytes 
_ 16396 and 16397, may contain the number 16500. This is held as 


01110100 0100000€ 


BYTES 16396 16397 


To obtain this value for use in a BASIC program the following instruc- 
tion may be used — it puts the value into a variable C. 


LET С=РЕЕК(16396)+256*РЕЕК( 16397} 


Some system variables (e.g. the seed for the random number generator) 
may be negative so, taking addresses 16412 and 16413 as examples, we 
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ADDRESS 


4K Monitor & 
Interpreter 


4096 


Expansion area R. 


8192 


Pointers at 


16392/3(VARS) 
16384 


17408 


16394/5(E-Line) 


16396/7(D-File) 


<— 16398/9(DF-EA) 


<— 16400/1 
(ОЕ-ЕМО) 
17407 | «— ВАМТОР 


Expansion area R 


32767 


Figure4 — ZX80 Memory layout 
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10 LET М-РЕЕК(16413) 
20 LET С=256* (М+256* (М> 127)+PEEK(16412) 


Тһе РОКЕ instruction is used іп ап analogous manner. 


Inverse Printing 


In considering the use of some of the system facilities, we look first at 
the program area (see Figure 4) starting at address 16424. The following 
routine may be used to convert text In PRINT statements to Inverse 
video. 


10 PRINT” ANY TEXT ” 
499 STOP 

500 LET O=0 

510 FOR А-16424 TO 16499 
520 LET C=PEEK(A) 
530 IF C=1 AND Q THEN STOP 
540 IF Q THEN POKE A,C+128 
550 IF С=1 THEN LET О=—1 
560 NEXT А 


Lines 10 to 499 represent the main program and the routine at line 500 
does the inversion. The program should be first run from line 500 (by 
RUN 500) and the listing will then reveal the text in line 10 as being in 
inverse video. Lines 500 onwards may then be erased and the main 
program SAVEd normally on cassette. The routine may easily be modi- 
fied to cover more PRINT statements. 


Timing 


Many games programs require a time limit to be placed on input, I.e. 
data will only be accepted if entered within a certain number of seconds. 
This may be achieved using the TV frame counter held in bytes 16414 
and 16415. This value is incremented fifty times each second and it is 
therefore simple to zeroise it before input and then PEEK its contents 
immediately afterwards. An example is given on the next page. 
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100 PRINT “ENTER DATA” 
110 POKE 16414,0 | 
120 РОКЕ 16415,0 

130 INPUT D$ 


140 IF (РЕЕК(16414)+256*РЕЕК(16415)—4)>Т*50 THEN 
PRINT "TOO SLOW" 


T he 4 is subtracted at line 140 to allow for the 80 msecs for the input 
data to reach the processor. T represents the number of seconds allowed 
for input. 


Machine Language Routines 


As stated earlier this book does not seek to teach Z80 machine language. 
However for users with such knowledge the following section shows how 
machine code routines can be set up and used from BASIC programs. 


The following program by Pat Crabb (with line 235 added by the authors) 
may be used to enter a routine. Note that the REM statement at the 
beginning of the program is used to hold the routine. 


100 REMCILIIIILI- |. ДО (64 shift A's) 
110 LET 5-16430 


120 LET А-5 

130 INPUT AS 

140 PRINT А,А% 

150 LET H=CODE(A$)—28 
160 LET A$=TL$(A$) 

170 LET L=CODE(A$)—28 
180 LET D=16*H+L 

190 POKE A,D 

200 IF D=201 THEN GO TO 230 
210 LET A=A+1 

220 GO TO 130 

230 INPUT A$ 
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235 IF AS-"Z" THEN STOP 
240 LET V=USR(S) 

250 LET A-(V AND 15)+28 

260 LET B-(V AND 15*16)/16+28 

270 LET C=(V AND 15*256)/256+28 

280 LET D=(V AND 7*4096)/4096 

290 LET D-D—8*(V«0)428 

300 PRINT CHR$(D) ;CHR$(C);CHR$(B) ;CHR$(A) 


Machine code instructions should be entered in hexadecimal, one byte at 
a time and terminating with C9 (the Z80 RET instruction). If newline is 
then entered the routine executes. If however the routine is to be used 
in a different BASIC program, Z may be input instead of only newline 
and the program will stop. All lines but the REM statement may then 
be deleted and the supporting BASIC program can be added and used. 
The REM statement will contain characters whose codes are equivalent 
to Z80 operation codes — Appendix 1 is useful for checking purposes and 
can in fact be used without the above program. Todo this, make a list 
of the machine code to be entered, byte by byte; next write alongside 
each the equivalent ZX80 character, or blank if no such character 15 
available from the keyboard; finally enter this list ina REM statement 
and POKE the values where blanks were used. This latter method is only 
recommended to be carried out for short routines which are required to 
be attached to a main BASIC program. Other methods are shown in the 
next chapter. 


Universal Machine Code Loader 


Another method of handling machine code routines is to store them in 
an area of RAM above the program and display file. This makes entry 
of routines much easier as shown by the following “universal machine 
code loader”. 


10 FOR | = 1700 TO x where x depends upon the length of 
20 PRINT I, the routine to be entered 

30 INPUT A 

40 РОКЕТА _ 

50 PRINT РЕЕК (1) 

60 NEXT | 


A corresponding machine code save routine appears in Section 4.4 
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CHAPTER FOUR — THE 7Х80 МОМТОВ 


4.1 INTRODUCTION 


The 7Х80 15 supplied with а АК preprogrammed Read-Only Memory. 
This 4K ROM is IC2. The term “4K” means that the chip contains 
4096 bytes, each filled with a binary number between 0000 0000 and 
1111 1111, or O to 255 decimal. This collection of 4096 binary codes 
forms the program (and associated tables) that runs the ZX80. The 
program is т Z80 machine code, whilst the tables are lists of numbers 
that are required by the program. 


The monitor can simply be divided into four functional parts: 


(1) Locations 0 to 1873 hold ап operating system that runs the 
cassette Input and output, the T V screen, and the keyboard. 


(11) Locations 1874 to 1981 hold the main BASIC command 
table. 


(iii) Locations 1982 to 3583 hold the BASIC interpreter. 
(iv) Locations 3584 to 4095 hold the character table. 


As in most computers, the monitor in the ZX80 can itself be examined 
using programs that actually are being run under the control of the 
monitor. In particular, BASIC programs can be written to examine the 
monitor that will itself be executing these BASIC programs. There are 
some limitations in this approach but this chapter contains a series of 
programs that can be used to examine all of the parts of the monitor. 

A knowledge of Z80 machine language is required for the later programs 
but there are many interesting features that can be demonstrated using 
BASIC alone. 


42 EXAMINING THE MONITOR 


The ‘PEEK’ Instruction 


The most useful BASIC instruction for examining the monitor is ‘PEEK’: 
by means of PEEK the contents of any specified location in the monitor 
may be copied and the result used in a BASIC program. 
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А simple program for beginning to ехатіпе Ше monitor need Бе по more 
complicated than the following:— 


10 INPUT A 

20 CLS 

30 PRINT 

40 PRINT "LOCATION PEEK VALUE” 
50 PRINT 

60 PRINT А,РЕЕК(А) 

70 GO TO 10 


The 'CHRS' Function 


The above program enables the user to access any of the locations in the 
monitor. However the values obtained do not form a very meaningful 
list and the program 15 laborious to use. Тһе next program 15 a more 
refined version and gets the computer to produce more information. The 
CHR$ command is used to produce the appropriate number, letter, 
graphic or keyword for the appropriate PEEK value. 


10 GO SUB 30 

20 GO TO 100 

30 PRINT" MONITOR LISTING PROGRAM” 

40 PRINT '' ==========================" 

50 RETURN 

60 FOR |= A TO А+ 15 

70 LET B = PEEK(I) 

80 PRINT 1,B,CHR$(B) 

90 NEXT | 

100 PRINT “ENTER THE STARTING LOCATION” 
110 PRINT “A NUMBER IN THE RANGE 0-4095” 
120 PRINT “ANY LETTER WILL STOP THE PROGRAM” 
130 INPUT A 

140 CLS 

150 IF A<Q ОН A>4095 THEN GO ТО 10 

160 СО SUB 30 

170 PRINT "LOC. PEEK CHR$” 

180 GO TO 60 
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Тһе addition of CHR$ (В) іп line 80 forms а method of decoding those 
parts of the monitor program that use ZX80 character codes. For 
example, there are tables for all the keyboard characters, the keywords 
and the Integral functions; these and the special characters 


inverse K, /, inverse >, inverse S and — 


may all be located using СНН% as above. 


Tables and Special Characters 


The following notes explain where these are found so that the user may 
experiment with the above program. 


Locations 108—185 


Locations 186—315 


This is the keyboard table from which the 
operating system gets an appropriate value for 
each key pressed. 


This is the keyword table which is used to ex- 
pand the keywords from their single-byte repres- 
entations (230—254) to a string of characters for 
printing. The last letter of each keyword has 128 
added to its value to mark the end of the key- 


‘word. Thus the addition of a line: 


75 IF B» 127 THEN LET B=B—128 

will make these words more intelligible. 
Location 315 is of particular interest as it holds 
the ''?" that is printed when the ZX80 expects a 
keyword and the key pressed does not have a 
corresponding keyword. 


Locations 3008-3052 This is the integral function table that is used for 


Location 647 


matching the integral functions that are entered 
letter-by-letter (e.g. PEEK, CHR$); the last 

letter of each word has 192 added to it to mark 
its end, and the addition of the lines: 

72 IF B» 191 THEN LET В-В--192 

75 IF B» 127 THEN LET B=B -128 

will make these words more intelligible. Between 
each word are two bytes that form an address for 
that function. 


T he ubiquitous “inverse K”. There is no corres- 
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ponding “inverse L” as that is obtained by 
incrementing the K. 


Location 1196 This is the “/” between the run error code and 
| the line number that appears at the bottom left 
of the screen at the end of a run. 


Location 1279 The current line marker — inverse >. 
Location 1312 The syntax error marker — inverse S. 
Location 1706 The minus sign, ''—'', that is printed in front of 


a negative number. 


The Character Table 


The largest table in the monitor is the character table, which is located 
from 3584 to 4095. The format of the locations in the table are dis- 
cussed in Chapters 3 and 5, and a program in section 3.6 shows how 
words may be printed in large characters using the table. The following 
program is similar, but enlarges single characters 64 times. 


20 PRINT“ ========== 
30 PRINT 

40 GO TO 310 

БО PRINT “YOU ASKED FOR THE CHARACTER —”: 
2 <2----СННФ(А)-"” 

60 PRINT 

70PRINT "LOC. РЕЕК CHARACTER” 
80 LET B=3584+A*8 

90 PRINT МеН 

100 FOR K=0 TO 7 

110 LET D=128 

120 PRINT 

130 LET C=PEEK(B) 

140 PRINT B.C, 

150 PRINT “*”. 

160 FOR І-0 TO 7 

170 IF C>D—1 THEN GO TO 200 
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180 PRINT 7 7; 

190 GO TO 220 

260 PRINT CHR$(128); 

210 LET C-C- D 

220 LET D-D/2 

230 NEXT | 

240 LET В=В+1 

250 PRINT “*”. 

260 NEXT K 

270 PRINT M TUNE C PH 

280 PRINT 

290 PRINT 

300 PRINT "TO GET THE NEXT CHARACTER" 
310 PRINT "PLEASE ENTER A NUMBER’ 
320 PRINT "BETWEEN O AND 63" 

330 INPUT A 

340 CLS 

350 IF A<O OR A>63 THEN GO TO 10 
360 PRINT 

3/0 PRINT 

380 GO TO 50 


Making the following changes will show inverse characters: — 


145 LET С-255-С 
320 PRINT "BETWEEN 128 AND 191" 
350 IF A« 128 OR A» 191 THEN GO TO 10 


The Remaining Tables 


In the monitor program there are six other tables. The numbers in these 
tables are mainly used to form the addresses of sub-routines within the 
operating system and the BASIC interpreter machine-code program. 

T he first table is 882—897 and it is a table of addresses for the sub- 
routines associated with the moving of the “cursor”. 


The details are as follows:— 
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The Cursor Table 


| Address of 

Location Peek Location Peek Product Sub-routine Key 
882 169 883 3 3*256 + 169 937 | 
884 213 885 2 2%256 + 213 725 | 
886 130 887 3 3*256 + 130 898 EE 
988 135 889 3 3*256 + 135 903 — 
890 185 891 3 3*256 + 185 953 Ноте 
892 203 893 3 3*256 + 203 971 Еди 
894 8 895 4 4%256 + 8 1032 N/L 
096 149 897 3 3%256 + 149 917 Rubout 


The BASIC command table 15 located at 1874-1981, and there 15 ап 
associated table at 2102—2108. 


These two tables give the sub-routine addresses and a command class 
number (0-6) for all the BASIC commands. However only the following 
‘соттапа$ yield simple sub-routine addresses. 


Command Sub-routine Address 

LIST 598 

RETURN 2405 

CLS 1863 

SAVE 438 

RANDOMISE 2339 

PRINT 2417 

МЕМ — 0 (What a surprise!) 
RUN 2365 

STOP 2350 
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Command Sub-routine Address 


LOAD 518 
CLEAR 1627 
REM 2122 


T he last three tables are at .— 


2723-2732 within BASIC interpreter 


3008—3052 Integral function table (Sub-routine 
addresses after strings) 


3359—3384 Relational operators (e.g. -3390,— 3385) 


but further details would not be helpful at this stage. 


The 'USR' Instruction 


The BASIC USR command enables machine code progress to be run 
from BASIC. The programs can either be written and entered by the 
programmer or selected from the monitor. The last table shows the sub- 
routine addresses for some of the BASIC commands and the USR 
command can be used with these addresses, but note that they do not all 
return successfully to BASIC. For example the SAVE sub-routine can be 
entered by RUN USR (438) rather than the usual SAVE. N/L. RUN 
USR (456) is dramatic because it is the SAVE routine without the initial 
waiting loop. 


57 


Figure 5 — Monitor Map (as described so Таг) 


s 


0 NEW 
108 KEYBOARD 


—185 
186 KEYWORD : 438 SAVE 
-315 г 518 LOAD 
512 598 LIST 
Operating 082 
System —897 Cursor 
1024 
1536 
1627 CLEAR 
1863 CLS 
1873 
1974 BASIC 
Command 
1981 table 
2048 
2122 REM 
2339 RANDOMISE 
2350 STOP 
2365 RUN 
BASIC 2405 RETURN 
п Interpreter 2417 PRINT 
3008 Integral 
- 3052 functions 
3072 
3359-84 Relational 
operators. 
3583 
3584 3584 
Character 
table 
4095 
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43 USING THE МОМПОК SUBROUTINES 


So far the monitor has been discussed as a program that can be examined, 
but of course the greatest benefits come from using parts of the monitor 
in machine code programs written by the user himself. 


As the locations 0 to 1873 form the operating system it is the sub- 
routines in this area that are of the most interest. The BASIC interpreter 
in locations 1982 to 3583 is а specialised program, and although the 
arithmetic subroutines can be used, the rest of the program is very com- 
plex and will not be discussed further in this volume. 


The subroutine memory map (Figure 6) shows the most important 
subroutines and these are discussed below in detail. The names given to 
the subroutines have been chosen to show their functions rather than to 
fit in with any assembly language standard. 


4.4 THE PERIPHERAL CONTROLLING ROUTINES 


1. Тһе Screen and Keyboard Routine (Locations 316 - 437, 
CALL at 319) 


This very important subroutine checks for keystrokes and, in the absence 
of a new keystroke, produces a frame for the ТУ output. 


The method of screen maintenance used is unique to the 7Х80 and isa 
complex combination of software and hardware features. The refresh 
facility of the Z80 microprocessor is used to read the contents of the 
display file and pass it via the character generator to the TV modulator. 


The routine is made up of three functional parts: 


(1) The frame counter is incremented 
(2) The keyboard is scanned 
(3) The current display file is passed to the TV modulator 


The routine exits at step 2 if a keystroke has been entered. 


The keyboard scan routine is located at 330 to 358 and produces an 
individual code for every key. The codes are to be found in the BC reg- 
ister pair. 
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НЕХ 


0136 


0186 


0206 


0560 


0562 


06А1 


06Е0 


0730. 


0747 


OBED 


SCREEN & 
KEYBOARD 


^. SAVE 


LOAD 


PRINT 


CHARACTERS 


END OF LINES 


PRINT NUMBERS 


CURRENT POSITION 


COLLECT 


CURRENT POSITION 


CLS 


ARITHMETIC 


ET 


STORE 


ИШ; 


С. 


DECIMAL 


316 


438 


518 


1376 


1474 


1697 


1760 


1852 


1863 


3053 
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THE 
PERIPHERAL 
CONTROLLING 
SUBROUTINES 


THE 
PRINT 
SUBROUTINES 


THE 
ARITHMETIC 
SUBROUTINES 


Figure 6 — Subroutine Memory Map 


There аге several ways of showing these Кеу-содез апа the following 
program gives them as decimal numbers: 


10 POKE 17000,205 

20 POKE 17001,63 Call subroutine screen and keyboard 
30 POKE 17002,1 

40 POKE 17003,96 LD H,B 

50 POKE 17004,105 LD L,C 

60 POKE 17005,201 Return 


To obtain a code use the direct command PRINT USR(17000) and press 
newline: the screen will flash but appear unaltered. The ZX80 is now in 
the SCREEN & KEYBOARD routine. Next press the required key and 
the appropriate key-code will appear at the top-left corner of the screen. 


To get other codes enter PRINT USR(17000) again. Note that the 
routine in this form will return to BASIC but if put in a loop it will 
corrupt its BASIC return. (Section 4.8 solves this problem). 


2. Тһе SAVE Routine (Locations 438 - 517, CALL at 438) 


This 15 the subroutine called by the Instruction SAVE and 15 normally 
used to SAVE BASIC programs on cassette tape. |t contains the timing 
loops for the 7Х80 cassette standard, and if a different standard were to 
be required then it is this routine and the corresponding LOAD routine 
that would have to be changed. 


The subroutine can be interrupted with the BREAK key, as both the 
‘pause’ part and the 'RAM-SAV Епа part contain the following codes 
that test for the BREAK Key: 


(From the 'pause' part) 

442 10 А #7Е 

444 IN A,FE 

446 RRA 

447 ЈАМЕ a... returns to command mode (i.e. 643) if 
BREAK detected. 


The КАМ-5АМЕ па part of the subroutine passes to the cassette output 
the contents of RAM from its start up to the beginning of the working 
area pointed to by E-LINE (held in locations 16394 and 16395). It is 
possible by changing the value in the E-LINE pointer to make the 
routine pass data to the cassette. However if the E-LINE value 15 
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changed, the SAVE routine must be called from а machine code program, 
and a corresponding LOAD routine must be used so that the ZX80 is 
reinitialised successfully. 


Most important, in this way it is possible to SAVE machine code pro- 
grams that have been placed in RAM above the BASIC program and the 
display file. The following routine is designed to do this, by simply 
changing the E-LINE value and jumping to the SAVE routine. 


17000 LD A,O 
17002 LD 16394,A 
17005 LD A,67 
17007 LD 16395,A 
17010 JMP 438 


This changes E-LINE to 17152 (i.e. 67x256 * O). Values other than 
67 and О in the first and third lines could clearly be used to produce 

a different E-LINE value. The above routine can be run by the direct 
command LET K-USR(17000), assuming it is stored at address 17000. 


The 'universal machine code loader' routine (see Section 3.7) can be 
used to enter this special SAVE routine, using the following decimal 
values for input: 


62 0, 50 10 64, 62 67, 50 11 64, 195 182 1 


3. Тһе LOAD Routine (Locations 518 to 597, CALL at 518) 


This is the subroutine called by the instruction LOAD, and is normally 
used to LOAD BASIC programs from a cassette into RAM. It will only 
accept tapes using the ZX80 cassette standard. 


The LOAD subroutine starts its LOADing into RAM at location 16384 
(4000H) and continues to LOAD until the last data has been received 
from the cassette. In normal working the system variables апа the | 
BASIC program and its variables are LOADed and the monitor returns 
successfully to the command mode entry point at address 643. 


However if a special machine code program cassette is LOADed (see 
previous section) using the LOAD instruction, a successful return to 
BASIC is no longer assured, and it requires the use of a corresponding 
special machine code LOAD program to LOAD it and reinitialise the 
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Z X80 successfully. 


The program below moves the LOAD subroutine to near the top of RAM 
and then alters what was location 516. The effect of this is to force a 
return to 627, a location in the initialisation block, rather than to 643, 
the command mode entry point. 


10 PRINT 
20 PRINT 
ЗО PRINT '"———MACHINE-CODE- LOADER" 
40 PRINT 


50 PRINT ,“BY IAN LOGAN” 

60 PRINT day Hole 17295, 62 
70PRINT,"—AUGUST 1980" sy was /721$,67 
80 PRINT 


90 PRINT 
100 FOR 1-504 TO 597 t 3 2. Соке 1235, 62. 


110 POKE 16700+,РЕЕК(І) iba Теке 11285, 6] 
120 МЕХТ | 
130 РОКЕ 17216,115 


140 PRINT “1. SET ТАРЕ TO START OF PAUSE" 
150 PRINT 

160 PRINT “2. PRESS PLAY” 

170PRINT ` 

180 PRINT “3. PRESS Ја NEWLINE” 

190 INPUT 25 

200 LET K-USR(17219) 


T he above program moves the LOAD routine to 17204 - 17797, and in 
that particular area the location to be changed is 17216 and the start is 
at 17219. 


45  THEPRINT ROUTINES 


The Display File 


In order to use the ZX80 monitor subroutines that control the printing 
of characters on the TV screen, it is essential to discuss in some detail 
the concept of the display file as it is used in the ZX80. 


The display file is that area of RAM that at a particular moment holds 
the characters that are to be shown on the next TV frame. 
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The monitor is so arranged that whenever the ‘keyboard and screen’ 
routine is called the display file contains the characters that form 24 
lines of display. However the display file has to be constructed character 
by character and therefore as a program is run (either the machine code 
monitor program or a BASIC program), the display is built up from its 
initial zero length to a final length that represents the 24 lines. 


T he display file lines are filled from the left, with respect to the TV 

frame, with the 2Х80 codes that represent the required characters. An 
empty line is represented only by a line-end character (118 decimal or 
76H), and a completely blank screen will have a display file of 26 line- 5 
end characters, i.e. а delimiter at ЖАҒАНЫ and one for each seseen line. 


э [пете] ле Ге 
E | E 24th 


D-FILE line- line- | line- 


е епа епа епа 
start 


delimiter 


SPARE STACK 


PROBLEM: Write a two line BASIC program that when run produces а 
completely blank screen. It may help to finish reading the chapter first 
(answer at the end!). 


Constructing the Display File 


Every display has to be constructed character by character and the 
easiest display to discuss is that requested by the programmer as the out- 
put from a BASIC program. 


To execute a BASIC program the command RUN is entered and this 
leads to the following events: 


(1) The current value for the start of the display file is collected 
from the D-FILE pointer. 


(2) The initial delimiter, 118, is stored in the D-FILE location. 


(3)  DF-EA and DF-END are made to point to the next location. 
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This in effect clears the display file апа it now has the format 


D-FILE DF-END 


| 118 | SPARE | | stack | 
Initial | 
delimiter 


(Note — this Is the CLS subroutine as described below) 


(4) The monitor now starts executing the BASIC program line by 
line and whenever a line containing the keyword PRINT is encountered 
the appropriate characters are added to the display file. For example 
the line 


10 PRINT “START” 
will change the display file to that illustrated below 


D- ге a END 


ТІГІГІГІГІГІГ 7 е 


Initial “G ый БЫ + ее чын dl ds 1st 


delimiter line- 
ned 
and the line 
30 PRINT A 


when A equals 16560, for example, gives 
D-FILE DF-END 


КЕШЕЕБ ve] |e] Ес 


Initial “so” Цена ан Ди 14 В” T: 1st ы! '' “6” “p” ug” ug 2nd 
delimiter lin line- 
end end 


(5) The execution of the program continues until it is stopped by 
one of the following five conditions: 


(а) The last line has been executed 
(b) A STOP instruction has been reached 


(c) An INPUT instruction has been reached 
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(d) | The display has been filled 
(e) There is insufficient room for the display 


T he effect of all these conditions with respect to the display file then 
follows the sequence below:— 


(1) А number of line-ends are added as required. 
(2) The E-LINE is copied into the display file. 
(3) More line-ends are added so as to complete 24 lines. 


(4) Тһе screen and keyboard subroutine is called, and the 
completed display file is decoded and shown on the 
TV screen. 


Тһе monitor adjusts the number of lines in the display file so that there is 
always sufficient room in the finished display for the E-LINE to be added, 
and so that there is sufficient RAM for the display even if this means 
showing an error 4 — out of available RAM. 


This program shows some of the features discussed above: 


N.B. 


10 PRINT "START" 

20 INPUT A --- Find a start address 
30 PRINT A | 

40 FOR | = А ТО А+49 

50 PRINT PEEK (1); “ ;CHRS(PEEK(I)), --- Print 50 peek values 
60 NEXT | x 

70 PRINT | 

80 PRINT “ТО CONTINUE PRESS N/L” --- Continue loop 

90 INPUT A$ 


100 LET А = А+50 - - - Increment start 
110 CLS 
120 GO ТО 30 - - - Loop back 


(1) Input 16561 to show start of display file. Remember that it 
is the display on the screen that is itself being illustrated by 
this program. 

(2) Input about 16983 to show the line “ТО CONTINUE PRESS 
N/L” as well as the E-LINE and the line-end characters (118) 
that complete the display file. 


The Position of the Display File 


An important point to be made is that the display file often moves up 
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and down RAM during the execution of a BASIC program, and this must 
be remembered if characters are to be POKEd into a partially completed 
display file during programs such as games. The problem arises because 
the variables area 15 held in RAM below the display file and as the 
variables area grows or shrinks in size, the display 15 copied up or down 
RAM. The following short program has been written to show this at a 
simple level: 


1) Enter: 20 GO SUB 100 
40 GO SUB 100 
99 STOP | m | 
100 PRINT "THE DISPLAY FILE IS NOW AT:— 
110 PRINT PEEK (16396) + PEEK (16397) “256 


120 RETURN 

2) RUN: The screen will show that the display file has not 
moved. 

3) Enter: 10 LET А-0 ог 10 INPUT А 
30 LET А-30 000 30 INPUT A 


RUN: Again the display file has not moved as all numerical 
variables are stored in 2 bytes, whether O or 30,000. 


4) Enter: 101ЕТ А-0 ог 10 LET А$ = "AS" 
30 LET B-0 30 LET B$ = "BS" 


RUN: The display file IS moved as a new variable has been 
used after the file had already been started. 


5) Enter: 10 LET A$=” ” ог 10 LET А5 = "ABCDE" 
30 LET А$= “ABCDE” 30 LET А$ =” ” 


All these move the display file up or down RAM depending on whether 
the variable area has been increased or decreased in size. 


The Current Display Position 


The monitor, whilst constructing the display file, keeps track of the 
current printing position by using locations 16421 to store the approp- 
riate line number and 16420 to store the appropriate column number. 
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Тһе following very simple programs show the locations in use. 


1) Program to show screen line numbers equalling Y values 


10 FOR І-1 TO 23 
20 PRINT “16421 SAYS THIS IS LINE” PEEK(16421) 
30 NEXT | 


2) Program to show screen column numbers equalling — X values 


10 FOR І-0 TO 21 

30 IF I-0 THEN GO TO 70 
40 FOR K=1 TO I 

50 PRINT 4; 

60 NEXT K 

70 PRINT PEEK(16420) 
80 NEXT | 


М.В. If line 20 PRINT “ **: is added the display is moved over. By 
increasing the number of spaces in line 20 the column numbers move to 
the right of the screen. When line 20 contains eleven spaces the program 
shows a code 1 in the first column. |f more than eleven spaces are put 
in line 20 it will be necessary to decrease the size of the loop, e.g. 10 
FOR 120 TO 10. 


The —Х, Y Convention 


It is useful to use a "—X,Y'' convention when discussing screen positions, 
as the values in 16421 correspond to Y values and the values in 16420 to 
—X values. This convention divides the screen as shown in Figure 7. 


Figure 7 — The —X, Y Screen Convention 


23 


24 Rows 
Y Address 16421 


(usually B prime 
register) 


—Х 
32 columns Address 16420 
(usually С prime register) 
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Тһе CLS Routine (Locations 1863-1873, CALL at 1863) 


This is а very short subroutine and it has been indirectly discussed under 
the heading ‘Constructing the Display File’ above. The purpose of the 
routine is to clear the display file, either after a direct command (no line | 
number) or a CLS instruction. Its function is outlined below — 


(1) Loads the HL register pair with the current D-FILE values. 


(2) Loads into the D-FILE location, now pointed to by the HL 
register pair, the initial delimiter 118. 


(3) Increments the HL register pair so that it points to the first 
spare location. 


(4) Loads the BC register pair with the values 23 and 33, 1.е. 
Y and —X for the top left-hand corner of the screen. 


(b) Jumps to the "current position store” routine. 


Тһе Current Position Store Routine 
(Locations 1852—1862, CALL at 1852) 


This routine is used to enter line-end characters into the display file. The 
number of line-end characters added depends on the Y value that is 
passed to the subroutine in the B prime register. 


It is useful at this stage to show the above subroutine being used by 
discussing the 'end of program' sequence that occupies the locations 1160 
to 1209. This sequence is followed when a direct command (apart from 
RUN and GO TO) has been executed, or the last line of a BASIC program 
has been executed, or a run error has occurred. The flow chart in Радни 
8 shows this рагі of the monitor. 


The Character Printing Routine (Locations 1366—1411, 
CALL at 1366 to add 28 to character values, or at 1376 to print ZX80 
characters 


This routine passes characters from the accumulator to the display file. 
The routine requires that the correct values for the DF-EA, the —X and 
the Y coordinates are available. It incorporates a test for error 4 (insuf- 
ficient RAM) and therefore signals an error when the display file reaches 
the stack. The routine changes the —X and Y values to point to the 
next screen location, so it Is usually followed by a call to the current 
position store subroutine. 
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d XO жа aX чети AS dace И. ~ -Е 


ENTER SEQUENCE 


KINN | CALL current 
position collect 
щы CALL end of 
lines 
1166 
LD B' #1 
LD С" #32 
НУ Тод A with 
run error code 
1173 


LOAD BC with 
current line number 


1177 


шығы PRINT run ! 


1 _ _ error code _ | 
CALL end of 
lines 
| CALL screen 
& Keyboard 
= ЈМР to command 
mode 


1201 


1204 


The display file ат this stage 15 
incomplete. 


Adds line-end characters to the 
display file, but leaves bottom 
line. 


Sets —X to 32 and Y to 1 
i.e. bottom left-hand corner 


Collect details of run 


_ error code 


Completes bottom line of 
display file. 


Any keystroke will clear the 
screen and return to the command 
mode. 


Figure8 — End of Program Sequence 
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Character Printing under Machine Code Control 


All the necessary subroutines that are required for character printing have 
now been discussed, but they must of course be used in a strict order. 
The flowchart below shows a suitable way to organise machine code 
printing. 


ENTER 


CALL CLS CALL CLS to clear the display file 
and collect the system variables, so 
that they are in the correct registers. 


+ Incorporates a 
| Jump to 
CURRENT POSITION 

|. COLLECT 


Load the accumulator with the ZX80 
character code for the character to be 
printed. 


Location 1824 is a useful location to use 
for character printing as it incorporates 
1) Print A by calling 1376 


E CALL 1824 — | 
2) А test for Error 5 — screen full. 
3) A call to current position store 
RETURN routine. 


Figure 9 — Machine Code Printing 


The following program shows the above system in use. In this example 
a BASIC loop has been added to print a string of characters, rather than 
a machine code loop, as this demonstrates the method more clearly. 


10 POKE 17000, 205 
20 POKE 17001, 71 CALL to CLS routine 
30 POKE 17002, 7 


40 POKE 17003, 205 
50 POKE 17004, 224 CALL to current position collect 


60 POKE 17005, 6 routine 
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80 РОКЕ 17007, 1 load A with character code 
90 POKE 17008, 205 | CALL to 1824 


70 POKE 17006, 62 | LDA.1 


100 POKE 17009, 32 (see flowchart above) 
110 POKE 17010, 7 
120 POKE 17011,201 } | RETURN 


Тһе above program will run using the direct command СЕТ K=USR17000 
but can also be controlled as follows : 


200 LET K=USR (17000) ... print character 1 

210 FOR | =2 ТО 63 

220 POKE 17007, | 

230 LET K=USR (17003) ... do not CALL CLS again! 
240 NEXT | 


The Number Printing Routine | 
(Locations 1697 to 1759, CALL at 1697) 


The routine is entered with a number, in two's complement notation, in 
the BC register pair. It splits the number into its respective digits and 
calls the character printing routine for each. A minus sign is printed if 
necessary. 


Number Printing under Machine Code Control 


The following flowchart shows a system for number printing : 


ENTER 


| CALL CLS | 

i jumps to | 

'ICURRENT POSITION: 
— 


Load BC register pair with the number 


LD ВС,?,? to be printed, in 1 two" s complement 
notation. 


Location 1796 is another useful location 
as it incorporates 
(1) Print numbers (2) A test for error 5 


— (3) A call to current position store routine 
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Тһе following BASIC programs shows number printing under machine 
code control. Once again a BASIC program loop has been added to show 
one method of printing different numbers 


10 POKE 17000,205 
20 POKE 17001, 71 CALL CLS 
30 POKE 17002, 7 


40 POKE 17003, 205 | CALL to the current position 
50 POKE 17004, 224 collect routine 
60 POKE 17005, 6 
70 POKE 17006, 1 Load BC with 00 
80 POKE 17007, 0 i.e. the number O 
90 POKE 17008, 0 
100 POKE 17009, 205 
110 POKE 17010,4 | САЦ 1796 
120 РОКЕ 17011, 7 


130 РОКЕ 17012,201 ) RETURN 


The above will run with the direct command LET K-USR(17000) or it 
can be repeatedly called from BASIC. 


e.g. 200LET K-USR(17000) 
210 FOR 1=1 ТО 20 
220 PRINT 
230 POKE 17007, ! 
240 LET K-USR(17003) -- Do not CALL CLS again 
250 NEXT ! 


4.6 THE ARITHMETIC SUB ROUTINES 


Locations 


The arithmetic subroutines in the monitor are as follows :— 


Subtraction 
Addition 
Multiplication 


Division 
Exponertiation 
AND 

OR 

(RND (X) 


Тһе subroutines must Бе supplied with the two numbers involved, іп the 
HL register pair and the DE register pair. The answer 15 returned in the 
HL register pair. Тһе RND is included here as it uses the multiplication 
subroutine. It is entered with the X value іп the HL register pair and it 
returns with RND(X) again in the HL register pair. It is noteworthy that 
LET K-USR(3053) returns random numbers in the range 0—3052 
inclusive. 


Demonstration of Multiplication Routine 


10 POKE 17000, 33 


20 POKE 17001,0 ГО HL, #00 

30 POKE 17002, 0 i.e. Zero 

40 POKE 17003, 17 

50 POKE 17004,0 ` LD DE, #00 

60 POKE 17005, 0 i.e. Zero 

70 POKE 17006, 205 

80 POKE 17007, 68 CALL 3396 

90 POKE 17008, 13 multiplication routine 


100 POKE 17009, 201 


This can be run by entering PRINT USR(17000) but the following BASIC 
Instructions give an interesting display. 


200 FOR I=0 TO 22 

210 POKE 17001,1 

220 POKE 17004, 

230 LET K-USR (17000) 
240 PRINT K 

250 NEXT | 


Demonstration of RND Function 


A pretty graph of random numbers can be drawn by the following 
program. In the program USR(3053) is used to generate random 
numbers in the range O to 3052 inclusive. The numbers are then arranged 
in blocks, i.e. 0—200, 200—400, etc. 


10 PRINT “RANDOM NUMBER GRAPH” 
20 PRINT E —————————————————-c'' 


30 PRINT 
40 DIM A(15) 
50 FOR І-1 TO 200 
60 LET R=USR(3053)/200 
70 LET A(R)=A(R)+1 
80 NEXT | 
90 PRINT “3052” 
100 LET N=3000 
110 FOR |=0 ТО 15 
120 IF N=0 THEN PRINT ^" “; 
130 IF N« 1000 THEN PRINT ”:”; 
140 PRINT М; ”; 
150 LET N-N- 200 
160 IF А(15—1)=0 THEN СО TO 200 
170 FOR К=1 TO 15-і 
180 PRINT "РА". 
190 NEXT K 
200 PRINT 
210 NEXT | 
220 PRINT "....0....5....1....1....2....2 
230 PRINT, “......0....5....0....5" 


М.В. Changing line 200 to 200 PRINT A(15—1) will put the actual 
numbers at the end of the graph lines. Lines 5O to 80 get 200 random 
numbers and divide them into 16 blocks, А(0) to A(15). Lines 90 to 230 
display array A so as to appear as a graph. 


This second program takes the 16 blocks as before but this time sorts 
them into a curve. It can be seen that the ВМО function always lead to 
quite an obvious curve! 


10 PRINT "RANDOM NUMBER GRAPH" 
20 PRINT "s 

30 PRINT 

40 DIM A(15) 

50 DIM B(15) 

60 FOR І-0 ТО 200 

70 LET R=USR(3053)/200 

80 LET A(R)=A(R)+1 


М.В. 


90 МЕХТ | 
100 РОВ I=0 ТО 7 
110 LET К-! 
120 GO SUB 300 
130 LET К=15—| 
140 СО SUB 300 
150 МЕХТ | 
160 ЕОВ І-0 ТО 15 
170 PRINT “+”; 
180 IF В(І)-0 THEN GO TO 220 
190 FOR K=1 TO B(I) —1 
200 PRINT " “: gag 
210 NEXT K 
220 PRINT "24" 
230 NEXT I 
240 FOR І-0 ТО 30 
250 PRINT “+”: 
260 МЕХТ | 
270 PRINT “..0....5....1....1....2...2" 
280 PRINT ,"...0....5....0....5" 
290 STOP 
300 LET М-50 
310 FOR J=0 TO 15 
320 IF NOT M>A(J) THEN GO TO 350 
330 LET M-A(J) 
340 LET L-J 
350 NEXT J 
360 LET B(K)-A(L) 
370 LET A(L)-40 


380 RETURN 

Lines 60 to 90 — collect random numbers in 16 groups 
Lines 100 to 150 — form curve into В(0) to B(15) 

Lines 300 to 380 — sort routine for curve 


Lines 160 to 290 — GRAPH output 
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4.7 MOVING 'RAMTOP' DOWN 


Protecting Machine Code Programs 


In many other computers it is very simple to protect machine code 
programs by moving the RAMTOP from its usual position above machine 
code programs to below these programs, so as to make them safe from 
overwriting. The following section shows how this may be done in the 
ZX80. A modification to the NEW statement (NEW n) is in fact used to 
do exactly this in the new ZX80 8K ROM (See Appendix 2). 


T he desired effect is as follows: 


é— ВАМТОР 


M/C PROGRAM 1 


ERI nun: 
SPARE 


A BASIC program fills A BASIC program reaches the 


M/C PROGRAM 1 


CRAMTOP 


RAM from below and can RAMTOP marker before getting to 
overwrite machine code machine code programs. 
programs. 


In the case of the ZX80 the stack is located at RAMTOP and below, and 
It is this "reaching the base of the stack” that stops a program — error 

code 4. The way to protect machine code programs in the ZX80 system 
is therefore to move the stack to below the machine code program area. 


The usual contents at the top of the stack are obtainable using the 
PEEK instruction. The top four bytes are: 


<-- RAMTOP 


- "Top of stack' marker pair 
STACK 186 _ 


Location 1095 
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Program to Show Stack Тор 


10 PRINT “STACK TOP” 
20 FOR 1=0 TO 7 

30 PRINT PEEK(17407-1) 
40 NEXT I 


Тһе value 1095 is the return address for every BASIC line execution, so 
that if the stack is moved using BASIC, this value must be put on the 
stack so that the BASIC program will return successfully. The following 
program shows one method of moving the stack, and involves jumping 
back to the initialisation routine at 619. It is not possible to transfer 
stack protection to and from cassette as there is no way of storing the 
stack pointer as a system variable . (The 83K ROM has not yet been 
studied sufficiently to ascertain whether it offers this facility). It is 
however possible to transfer the machine code program that moves the 
stack. 


10 PRINT "THIS PROGRAM ENABLES" 
20 PRINT "THE STACK TO BE MOVED" 
30 PRINT "ENTER NEW STACK LOCATION" 
40 PRINT "I.E. 16900" | 
50 INPUT A 
60 LET Н-А/256 
70 LET L = A—H*256 
80 POKE 17000,33 
90 POKE 17001, L 
100 POKE 17002,H 
110 POKE 17003,195 
120 POKE 17004,107 
130 POKE 17005,2 
140 LET K=USR(17000) 2 
“This Phukan werd Ким, Does Dese 
ISELE, 
4.8 MOVING DISPLAY ROUTINE 


Finally, what every ZX80 user has been waiting for — moving displays. 
The following program allows the user to generate several screen-fulls of 
output and the ZX80 cycles through them. To run the program enter 


1) LIST 
78 


2) LIST 400 — to obtain а small display file 
3) RUN 200 


Enter break То stop. 


To obtain further pages of display enter similar sequences to 200—290 
апа 300—390. 


5 LET K=USR(17350) 


6 RETURN 
10 FOR 1-316 TO 437 moves screen & keyboard 
15 POKE I +16900,PEEK(I) routine into RAM 
20 NEXT | 
30 РОКЕ 17388,255 ... timing counter (number of 
frames 
32 POKE 17219,24 | 
jump out 


34 POKE 17220,239 
36 POKE 17204,58 
38 POKE 17205,186 
40 POKE 17206,67 
42 РОКЕ 17207,61 
44 РОКЕ 17208,200 
46 РОКЕ 17209,0 
48 РОКЕ 17210,0 
50 РОКЕ 17211,50 
52 РОКЕ 17212,186 
54 РОКЕ 17213,67 


56 РОКЕ 17214 24 | 
79 


read counter 


jump back in 
58 POKE 17215,7 


60 POKE 17350,205 
62 POKE 17351,67 
64 POKE 17352,67 
66 POKE 17353,33 
68 POKE 17354,55 
70 POKE 17355,64 
72 POKE 17356,34 
74 POKE 17357,38 
76 POKE 17358,64 
78 POKE 17359,201 


the control routine. 
(lines 70—72 specify the 
address of the line-end 
character in line 5) 


80 RETURN 
200 СО SUB 10 
210 CLS 
220 PRINT "***HELLO***" 
230 POKE 16421 РЕЕК(16421)+1 remove last line 
240 FOR І-1 TO 20 | fill file 
250 PRINT 
260 NEXT | 
290 GO SUB 5 
300 GO SUB 10 
310 CLS 
320 PRINT "***GOODBYE***" 
330 POKE 16421,PEEK(16421)+1 
340 FOR І-1 TO 20 
350 PRINT 
360 NEXT | 
390 GO SUB 5 
400 GO TO 200 


The above program, just as much of this chapter, has been written for a 
ТК ZX80, but "moving display" programs really do look better when 
relocated for a 4K machine. 


ANSWER IO PROBLEM ON PAGE 64 


The following two line BASIC program produces a completely blank 
screen. 


10 PRINT "A" 
20 POKE 16446,118 


Supplementary Problem: Give a proof that the above program does 
what you think it does. Answers on a postcard please to lan Logan, 
с/о LINSAC! 
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CHAPTER Е! МЕ — CONSTRUCTION & HARDWARE 


5.1 INTRODUCTION 


Construction 


This chapter does not attempt to give full constructional details on the 
ZX80, to do so would be to duplicate Sinclair's assembly instructions. 
It is however intended to complement them. 


The kit is aimed at the person with a reasonable amount of construc- 
tional experience, it is not for the complete novice. The authors recom- 
mend that those who do not possess such experience do not try to gain 
experience by building the ZX80. А ready assembled version is available 
at the time of printing for £99.95 which may save you the trouble of 
sending the kit back to Sinclair if it does not work, as well as the cost of 
repair. 


However for those who desire a challenge, buying the kit is a good way 
ОТ saving yourself £20, which will pay for a power supply and a generous 
amount of C12 tapes. ІТ, after all your efforts, the kit refuses to work, 
Sinclair will get it going for you for a minimum charge of £10. Please 
note however that Sinclair will NOT assemble or complete the assembly 
of a ZX80 kit. 


Apart from your ZX80 all you will need is a power supply, available from 
oinclair for £8.95 — or build your own, a television set and a cassette 
recorder. Join these together, with the leads supplied and you have a 
complete home computer, waiting to be programmed. 


5.2 | ASSEMBLY 


Before attempting to assemble the kit we recommend reading through 
Sinclair's assembly instructions at least twice, or until you are familiar 
with all the steps in the construction of the kit. Sinclair have, we аге 
happy to say, provided instructions that could be called “Модду builds 
a computer". They have kept the number of things to do to a minimum, 
which makes construction of the kit a pleasure rather than an endurance 
course. We took about three hours to build the kit but would suggest 

81 | 


that five hours will be about average for its construction. This is going to 
be one of its greatest selling points as you can be programming in BASIC 
within five hours of the kit's arrival. 


Provided you follow Sinclair's instructions very little can go wrong with 
the construction of the kit. They really have tried to make construction 
easy and to enable you to get the right bits in the right places. The 
assembly instructions include a components list, a component location 
diagram, a circuit diagram and fairly explicit constructional details. 


T he kit itself is of a very high standard, the keyboard being a part of the 
main board. The РСВ is double sided with plated through holes. If you 
can remember as far back as Sinclair's “Cambridge” calculator kit, as we 
can, Just looking at the board makes you realise how quickly things have 
developed in the last six years. We recommend inspecting the board 
visually for solder “bridges” or breaks іп any of the tracks. We also 
suggest checking each of the components as much as you can before 
insertion. Resistors can be wrongly coded and diodes can be short 
circuit or open circuit, etc. Although we did not find faults on the 
board or any components, checking of both may save you time and 
possibly money later. Once you are satisfied that all is well, construc- 
tion may commence. | 


When everything is soldered onto the board we suggest testing the board 
prior to inserting the socketed i.c.'s. Sinclair have kept the amount of 
tools necessary for the construction of the kit to a minimum and it can 
be built with those tools, but a greater degree of confidence can be 
added if you have or have access to a multimeter and possibly an oscillo- 
scope. 


Once you have finished soldering, check the board again visually for any 
solder “bridges” or holes left unsoldered which have component legs in 
them. Next power up the board and check the voltage going Into the 
voltage regulator (i.c. 22) and the voltage coming out. The input 
voltage must be at least seven volts, if it is not, the voltage regulator will 
not work properly. The output voltage must be between 4.75 and 5.25 
volts, any voltage outside of these two extremes is not acceptable as it 
will damage the i.c.'s. If the output voltage is found to be less than 
4.75 volts then check the board again for short circuits between the O 
volt and the +5 volt supply rails. If the output voltage is inside these 
two limits then check that power actually gets to the correct pins on the 
top of each i.c. socket. (The circuit diagram shows where the +5 volt 
and O volt pins are on each i.c.). When you have established that power 
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actually goes То each І.с. socket then after powering down the board the 
i.c. ѕ can be inserted. Make sure that all are in the correct way round. 


It 15 now time to make connection to the T.V. — turn оп the T.V. and let 
it warm up, then connect the video lead from the ОНЕ modulator into | 
the T.V. aerial socket. Turn on the ZX80 and the cursor (a black square 
with a white K in it) should appear on the bottom left hand corner of 
the screen. Sinclair specify that the T.V. should be tuned to UHF 
channel 36 but it may vary slightly and they suggest that you try any- 
where between channels 33 and 39 until you get the best picture. 

N.B. brightness and contrast controls may need to be уапед to give the 
best character definition. 


Hopefully your kit will work first time (ours did) if it does not do not 
panic. Read through the section on faults in the assembly instructions 
and see if any of the faults listed there corresponds with the fault you 
have. If none of them do and the power supply voltages are correct then 
without at least an oscilloscope the things you will be able to do will be 
very limited. If you do have access to an oscilloscope you can check that 
the Z80 (i.c. 1) has the correct clock signal going to it. The clock signal 
(j may be found on pins 10 and 12 of i.c. 15. Unless you have a wide- 
band oscilloscope this will look like a 3.25 MHz sinewave, it should in 
fact be approximately a square-wave varying between normal TTL levels. 
This signal should also be found on the Z80 (i.c. 1) pin 6. If the clock 
signal is found on pin 6 but ooperation is still not evident then the levels 
on four inputs to the Z80 should be checked. The voltage levels on 
RESET, BUSRO, WAIT and NMI, pins 26, 25, 24 апа 17 of i.c. 1 
should all be greater than 2.4 volts. If any are below 2.4 volts then 
checks should be made on the pull-up resistors, R21, R22, R23 and R12. 
All of these signals are brought out to the back edge connector of the 
ZX80 so if a fault exists check also that there аге no solder ''bridges'' on 
the edge connector. 


If after trying the above the fault still exists, and you have checked that 
all the 1.с. 5 are correctly seated in their correct sockets, then we recom- 
mend sending your kit back to Sinclair as the fault, most probably, is 
beyond repair without more specialised equipment. 


53 HARDWARE 


The ZX80 is controlled by an NEC 780-1 microprocessor which 15 a copy 
of the very successful Z80, hence the name. The CPU is used to contro! 
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all the functions of Ше 2Х80, including driving Ше Т.М. display апа the 
cassette recorder. Sinclair have opted for this approach in order to keep 
the system compact, by doing so they have saved 1.с.5, board area and 
also costs which is reflected in the price of the machine. The CPU runs 
at 3.25 MHz which as it happens is a convenient multiple of the T.V. line 
frequency (15.625 KHz). Since the CPU drives the display then whilst 
the CPU is processing data the display disappears, i.e. when data is input 
from the keyboard, calculations are taking place or data is being loaded 
from or stored on a cassette. We found the “blinking” of the display 
when accepting input from the keyboard a positive help as it signifies 
acceptance of each keystroke. 


Display 


T he display itself is very clear, the picture 15 rock steady and there 15 the 
option of having white characters on a black background. For those who 
want this option to be switchable a one pole two way switch inserted via 
a couple of wires in place of links A—C and А-В оп the underside of the 
main РСВ will give you this option at your fingertips. М is advisable 
however to make the wires as short as possible. 


A one volt composite video signal is available for use with a monitor if it 
is required. This signal normally feeds the UHF modulator but could be 
taken out and fed, via a buffer circuit, to a monitor. The authors feel 
this is probably unnecessary as the standard of the display is already 
very high. Details of this modification are to be provided by Sinclair at 
a later date. | | 


The display consists of 24 lines each of 32 characters, 768 displayable 
characters thus being possible. It 15 not memory mapped, іп fact № Is 
treated like a serial file. It is possible, using POKE, to put characters 
into the display file area, however all variables must be assigned values 
before you do this. This however does not make moving graphics a 
possibility since while the CPU 15 processing data the display 15 blanked. 


Character Set 


The number of displayable characters can be extended by using the 
character generator contained in the main ROM in your own program. 
Тһе character generator is located at addresses OEOO to ОҒЕР Пеха- 
decimal. Each character takes up eight bytes, as shown in the following 
example. 
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Address Data 


OEO8 00 
OEO9 14 
OEOA 14 
OEOB 00 T hese eight bytes correspond to 
OEOC 00 character number 1 in the character 
OEOD 00 generator set which 18” 
OEOE 00 
OEOF 00 
i.e. 
ОЕО8 0 0 ооо о о 0 
ОЕО9 0 0 0 1 0 1 0 0 
ОЕОА 0 0 0 1 0 1 0 0 
ОЕОВ 0 O о о 0 о о 0 
ОЕОС 0 9 о 0 0 о о о which=” 
ОЕОО о о 0 0 о о о 0 
ОЕОЕ 0 0 о O о о о 0 
OEOF 0 о о 0 о о о 0 


Bits set to logic 1 are normally displayed as black (white when using 
inverse video). The graphics characters use the full eight by eight matrix, 
whereas the alpha-numeric characters only use a matrix of six by eight 
dots. Larger characters can be obtained in your own programs by looking 
at each byte of the character in turn and displaying any one character of 
the normal character set when a bit is set to logic 1 in the byte, otherwise 
display a space. (See Section 3.6) 


Use of the memory display program in Chapter 6 is very useful when 
looking at the character generator section of the ROM as the display format 
Is as shown below :— 


Address Data 


OE58 O0 1E 21 78 20 20 7Ғ OO 
OEG0  .. 
OE68 ТА etc. 
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Тһе format used is Ше address (іп һех) followed Бу eight дата bytes 
(in hex) which in this case correspond to a complete character, actually 
a Е sign. Use of this format allows you to see one "'character'' of the 
character generator on each line of the display. 


Keyboard 


The keyboard of the ZX80 is attached to the main PCB. It is waterproof 
and chemical proof so if you spill your coffee on the ZX80 you will not 
have the problem of the keys being stuck. It is touch sensitive and has 

a standard typewriter layout, though compressed. The key symbols are 
printed on the underside of the plastic coating so they will not rub off 
with wear. 


It 15 recommended that when using the keyboard a rolling or wiping 
action is used instead of the more usual tapping movement as this tends 
to produce, much more consistently, correct entry of characters. 


The 2Х80 switches the function of the keys on the keyboard between 
keywords and characters as it checks the syntax of your statements. 

T hus at the command level typing R will produce the command RUN 
whereas if you were typing in a program line and you used the key R 
after a command the display would show R as in :— 


100 LET R = A*B 


Cassette Interface 


T he cassette interface data format is unique to the ZX80 and is not com- 
patible with any other computer system. The ZX80 does not use the 
more popular Kansas City cassette interface as to have done so would 
have required more integrated circuits and more board area. However it 
does work quite well. We initially had some problems with our machine 
not loading programs when the voltage regulator became hot. This has 
been alleviated by using a thicker insulator between the heatsink and the 
board, thus cooling the board and the surrounding integrated circuits. 

If you do experience this problem turn off the machine and leave it to 
cool down for five. minutes or so, after which time it will work quite 
happily. 


Connection is made to a standard cassette recorder via two 3.5mm jack 
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sockets. The leads provided with the ZX80 have matching 3.5mm jack 
plugs but if your cassette recorder has a DIN connection then a DIN 
jack connector can be bought from most electrical stores. However, 
since the DIN connection gives a lower output signal and the ZX80 is 
somewhat “hard of hearing'', such connections are not recommended. 


Two other points have been noticed about the cassette interface, they 
are:— 


1. Some recorders may record noises when the CPU is supposed 
to be sending out five seconds of silence. This may be due to the 
"ear'' jack being in circuit. It is therefore recommended that the 
"ear'' jack is disconnected before issuing the SAVE command. 


2.  LOADing of files from a cassette works better if the tape is 
moved into the silent part of the file, preceding the file header 
record, before issuing the LOAD command. 


At present there are no file handling facilities available other than 
LOAD and SAVE. However a new ROM is being developed that 
will include such routines and will enable you to name your files 
and write them to cassette and possibly discs. 


Mains Adaptor 


T he mains adaptor available from Sinclair gives an output of about 
600mA at 9 volts DC. This voltage is unregulated as the ZX80 has its 
own on board voltage regulator (ic 22). Sinclair's adaptor is handy, but 
If you want to make your own, any power supply that gives an output 
of about 9 volts at 600mA will suffice. N.B. If you do buy the Sinclair 
adaptor do not leave it on all day: we did and blew the thermal fuse that 
is inside the adaptor. 


Edge Connector 


At the rear of the ZX80 there is a forty six way double sided edge con- 
nector, (standard 0.1” pitch). The signals that are brought to this 
connector are; 


8 data lines, DO to D7 
16 address lines, AO to A15 
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1 3.25 МН? сіоск 

1 chip select for external RAM, НАМ CS 
1 5 volt stabilised power supply line 

1 9—11 volt unstabilised power supply line 
2 Ovolt lines 


The locations of which are shown in the following diagram. 


IB} qv B Ø |^ A | № | An | Aw | Аз | А, A, 


SV SLOT ON Ао Аз Ais Ps Ан. Аа А? Ас МС 
| А »À А , ' i AUS МЕНИ MWST. ENT wassap —r —O 25А 
Ам | Do 0; 05 D4 NMI | MREQ | RO | BUSAK] GuSRQ| MI 
07 ао О, Dc Оз іт HALT IORQ WR WAIT RESET RESH 


The edge connector is used for the memory expansion boards. It should 


be noted that the data and address lines are not buffered and as yet there 


аге no 1/0 ports on the ZX80. If it is desired a RESET switch сап be 
attached to the edge connector between RESET and O volts. It should 
be a momentary action push to make switch. This switch has the same 
effect as pulling the power supply plug out of the ZX80. It should only 
be used when control of the machine has been lost as both program and 
variables are destroyed. 


An explanation of all of the control lines has not been given as it would 
be duplicating data which is much more comprehensively dealt with in 

other more specialised publications. A list of recommended books can 

be found at the end of this chapter. 


ROM 


At present the operating system, monitor, BASIC interpreter and 


character generator are all contained in a 4K byte ROM, (See Chapter 4). 


This ROM is pin-compatible with the Texas Instruments ТМ52532 
EPROM so ІҒ you have EPROM programming facilities It would be 
possible to write your own programs and pop it in place of the system 
ROM. Shortly Sinclair will be bringing out an 8K byte ROM that will 
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overcome the shortcomings of the system at present. It will contain the 
trigonometrical, logarithmic and floating point arithmetic functions that 
are missing at present and will also contain file handling routines. Thus 
the ZX80 will be able to read and write files to tape, calling them by 
name. It will also, it is hoped be able to access discs. The new ROM isa 
plug in replacement for the existing ROM and will cost around £20. 


RAM 


The ZX80 is supplied with ТК byte of RAM as standard. The 1.с.5 used 
are standard 1024 x 4 bit NMOS Random Access Memories. Extra RAM 
can be added to the system via the rear edge connector. Science of 
Cambridge are selling memory expansion boards which each take a 
further 3K bytes of RAM, the memory chips being sold separately in 

1K byte increments. Several other companies are now offering memory 
expansion for the ZX80, both 4K byte and 16K byte expansions being 
offered at the time of writing. 


I/O 


At present Sinclair are not marketing an 1/0 bus for the ZX80. It is 
however possible to attach one via the edge connector. I/O will most 
likely be memory mapped, i.e. Input or output ports will look like 
memory locations to the microprocessor. As the ZX80 uses ЈОКО as 
part of the decoding for the keyboard and some address lines are used 
for different functions you must be very careful if you try to attach a 
normal І/О bus to the ZX80. It would seem that by far the easiest way 
of attaching 1/О is to make it memory mapped. 
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780-1 
2332 
2114 
2114-1 
7415373 
7415157 
7415157 
7415157 
7415165 
7415365 
741500 
741500 
741504 
741505 
741505 
741510 
741532 
741532 
741574 
741586 
741593 
7805 


ZX80 IC LIST 


Functional Description 


Z80 equivalent microprocessor 
4K byte ROM 

1K x 4bit RAM 

1K x 4bit RAM 

Octal transparent latch 

Ouad 2 to 1 line data selector 
Ouad 2 to 1 line data selector 
Quad 2 to 1 line data selector 
8 bit shift register (Р.1.5.О.) 
Hex bus driver 3-state 

Quad 2 input NAND gates 
Quad 2 input NAND gates 
Hex inverter 

Hex inverter (open collector) 
Hex inverter (open collector) 
Triple 3 input NAND gates 
Quad 2 input OR gates 

Quad 2 input OR gates 

Dual D-type flip flop 

Quad exclusive OR gates 

4 bit binary counter 


+b volt voltage regulator 
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CHAPTER SIX - 2Х80 PROGRAMS 


The following pages contain a selection of programs from the current 
LINSAC program library. 


All programs are available on C12 cassettes and copies of the program 
catalogue are available from LINSAC. 


REF. NO. E002 DOCUMENTATION · 


PATTERN RECOGNITION 


PROGRAM DESCRIPTION 


Tests the player's ability to recognise the number of a random collection 
of dots, within a time limit. There are five questions. The player speci- 
fies the maximum number of dots required. At the end the player is 
notified of his score. 


Glenn Doman uses similar methods to teach children mathematics — see 
his book “Теасһ Your Baby Maths". 


INSTRUCTIONS 
T ype RUN and NEWLINE once program is loaded. 


T he program first requires that the maximum number of dots wanted 
should be entered. Any value outside the range 10 to 100 is ignored. 


T he player requests each question when prompted by pressing the 
NEWLINE key (N/L). 


Once the pattern has been displayed the player has ten seconds to esti- 
mate the number of dots. After entry of his guess he 15 notified of its 
accuracy or otherwise, unless he is outside the time limit. At the end of 
five questions the player may obtain his overall score by pressing NEW- 
LINE when prompted. 
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LIST ОҒ VARIABLES 


X = the number of correct answers 

Y = the number of answers within 5 of the correct 
numbers 

Z = the number of answers within 10 of the correct 
numbers 

M = the maximum number of dots, chosen by player 
(10 — 100) 

G = sequence number of the go 

N$ = dummy variable 

R = the actual number of dots 

IJ = loop counters | 

N = the number estimated by the player 

D = the modulus of the difference between R and N 

SAMPLE RUN 
o DOTS o 
MAX (10 — 100) = 99 
5 QUESTIONS 
N/L FOR GO 1 


Newline entered, screen clears 
A collection of dots is displayed 
HOW МАМУ? 

68 entered, screen clears 

68 

YOU WERE 3 ОЦТ 

THERE WERE 65 DOTS 


N/L FOR GO 2 

Newline entered, screen clears 
A collection of dots 15 displayed 
HOW МАМУ? 

55 entered, screen clears 

55 | 

YOU МЕВЕ 30 OUT 

THERE WERE 85 DOTS 


N/L FOR GO3 

Newline entered, screen clears 

A collection of dots is displayed 
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SAMPLE КОМ continued 


HOW MANY? 

45 entered, screen clears 
45 

YOU WERE 4OUT 
THERE WERE 41 DOTS 


N/L FOR GO 4 

Newline entered, screen clears 

A collection of dots is displayed 

HOW MANY? 

42 entered after some delay, screen clears 
TOO SLOW 

THERE WERE 44 DOTS 


N/L FOR GO 5 
Newline entered, screen clears 
A collection of dots is displayed 
HOW МАМУ? 
13 entered, screen clears 
13 
o CORRECT o 
END 
N/L FOR SCORE 
Newline entered, screen clears 
YOU СОТ 1 CORRECT 
2 WITHIN 5 
O WITHIN 10 


Program ends 


PROGRAM LISTING REF 2002 


10 RANDOMISE 

20 PRINT ,"DOTS" 

25 PRINT “МАХ(10-100)-”; 
30INPUTM | 

32 IF M«10 OR M» 100 THEN GO TO 30 
3b PRINT M 
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PROGRAM LISTING Contined 


40 PRINT 
60 FOR G=1 TO 5 
70 PRINT “N/L FOR GO";G 
80 INPUT М% 
90 CLS 
100 LET R=RND(M) 
110 FOR 1=1 TOR 
120 PRINT "=": 
122 FOR J=1 TO RND(2) 
124 PRINT " "7: 
126 NEXT J 
130 NEXT I 
150 PRINT 
160 PRINT "HOW MANY?" 
162 POKE 16414,0 
164 POKE 16415,0 
170 INPUT N 
171 CLS 
172 IF (РЕЕК(16415)*256+РЕЕК (16414)—4)>500 THEN 
GO TO 225 | 
180 PRINT N 
190 IF N-R THEN GO TO 230 
192 LET D=ABS(N—R) 
195 PRINT “YOU WERE "О; OUT" 
200 IF D«6 THEN GO TO 250 
210 IF D«11 THEN GO TO 280 
220 GO TO 300 
225 PRINT "TOO SLOW" 
227 GO TO 300 
230 PRINT “ CORRECT " 
240 LET Х=Х+1 
245 СО ТО 310 
250 LET Y=Y+1 
260 GO TO 300 
280 LET Z=Z+1 
ЗОО PRINT "THERE WERE '*R;" DOTS” 
310 NEXT G 
320 PRINT 


330 PRINT "END" 
340 PRINT “N/L FOR SCORE" 
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PROGRAM LISTING continued 


350 INPUT N$ 

360 CLS 

370 PRINT “YOU GOT”,X;” CORRECT" 
380 PRINT УУ WITHIN 5” 

390 PRINT ,Z;" WITHIN 10" 

400 STOP 


LINSAC REF. NO. 0001 DOCUMENTATION 


MEMORY DISPLAY 


PROGRAM DESCRIPTION 


Displays 80 byte blocks of memory in hexadecimal or character form 
starting at an address as input. 


Contains decimal to hexadecimal conversion routine. 


INSTRUCTIONS 
Press RUN. 
Input starting address between 1 and 32767. 


On prompt type NEWLINE for display of next 80 byte block or Z to 
stop. 


N.B. Some time is taken to set up and output each block. 


LIST OF VARIABLES 


А1 = nearest multiple of 16 at which memory display to 
commence. 

A - pointer to current address being considered 

A$ = dummy variable 

X = parameter passed to subroutine 300 containing 
decimal number for conversion 

C = decimal contents of address А 
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LINSAC REF. МО. 0001 ` DOCUMENTATION 
MEMORY DISPLAY 


SAMPLE RUN 


MEMORY DISPLAY 
START ADDRESS (DECIMAL)? 
o HEX OR CHARACTERS? HEX 


Screen clears, delay 

4000 FF El 46 00 06 42 00 00 
4008 00 42 25 42 25 42 62 42 
N/L (or Z) 

Newline entered, screen clears, delay 

4010 31 42 15 00 00 00 00 19 


4018 00 бА 
4020 ED 

4028 00 С. 

4030 32 

4058 26 31 09 ОҒ 01 76 OO 06 
N/L (ОВ Z) | 

7 

Stops 


PROGRAM LISTING 


2 PRINT, “MEMORY DISPLAY” 
3 PRINT 
4 PRINT "START ADDRESS (DECIMAL)?'; 
5 INPUT A1 
6 PRINT A1, "HEX OR CHARACTERS?" 
7 INPUT A$ 
В LET H=(CODE(A$)=45)} 
9 CLS 
10 LET A1=80*(A1/80) 
20 FOR A=A1 TO 32767 
21 IF NOT A=80*(A/80) THEN GO TO 30 
22 PRINT 
23 PRINT "N/L (OR Z)” 
24 INPUT A$ 
25 IF A$ = “Z” THEN STOP 
26 CLS 
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PROGRAM LISTING continued 


28 PRINT “ADDRESS”,, “CONTENTS” 
30 IF NOT A=8*(A/8) THEN GO TO 70 
35 PRINT 
40 LET X=A 
50 GO SUB 300 
60 PRINT, 
70 LET С-РЕЕК(А) 
75 |Е H THEN GO TO 90 
80 PRINT CHR$(C); 
85 GO TO 110 
90 LET Х-С 
100 GO SUB 320 
110 PRINT " 7; 
170 NEXT A 
180 STOP 
300 REM DEC TO HEX 
310 PRINT CHR$((X AND 28672) /4096+28); 
CHR$((X AND 3840)/256 + 28); 
320 PRINT CHR$ ((X AND 240) /16+28); 
CHR$ (( X AND 15) +28); 
330 RETURN 


LINSAC REF. NO. E004 DOCUMENTATION 
SPELLING QUIZ 


PROGRAM DESCRIPTION 

A spelling drill in two parts. 

In the first part the teacher inputs five words to be used in the quiz. 

In the second part the pupil is shown each word in turn and then asked to 


spell it. If incorrect the letters in error are highlighted. At the end the 
number of words correctly spelled is shown. 


INSTRUCTIONS 


Teacher: When the program has been loaded, type RUN NEWLINE. 
(Terminate all input by NEWLINE). 
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REF. МО. Е004 DOCUMENTATION 
SPELLING QUIZ 


INSTRUCTIONS continued 
When prompted enter five words, each terminated by NEWLINE. 


When the program has acknowledged these by 'T HANKS', the program 
may be used by the pupil. (N.B. maximum total of 50 letters). 


Pupil: Press NEWLINE CONT NEWLINE. 
Five words will be shown in turn. After seeing the word, press NEW- 
LINE when prompted, and then repeat it. You will be shown any mis- 


takes you may п:аКе and at the end your score will be given. 


The quiz may be rerun by the command GO TO 200. . 


LIST OF VARIABLES 


M = total number of letters in all words + 1 
Array C = character codes of letters in words ` 
Array S = shows starting position of Array C where each word 
Is held. 
Array E = shows ending position of Array C where each word 
Is held. 
| = the sequence number of the words being entered/ 
tested. 
W$ = the word being input by the teacher 
T = number of words spelled correctly 
Z$ = dummy string variable 
X$ = word as spelt by pupil | 
J = pointer to character in Array C. Also used as dummy 
— high value in one Instance. 
K = loop counter 


Two subroutines used 


SR500 — given a word W$ it enters its character codes at the 
| next free position of Array C, setting 5(1) and Е (1) 
accordingly. 
SR600 - printsaword from Array C, characters from and 


including position J in inverse video. 
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REF. МО. Е004 DOCUMENTATION 
SPELLING QUIZ 


SAMPLE RUN 


ENTER o 5 o WORDS 


DWARF | 
DRAGON ) 
ELVES ) Words set up by teacher 
FAERIES | 
LEPRECHAUNS | 
Screen clears 

THANKS 

NEWLINE CONT NEWLINE entered 
WORD 1 = DWARF 

PRESS NL 

Newline entered, screen clears 
SPELL 

DWARF 

Screen clears 

DWARF 15 CORRECT 

WORD 2 = DRAGON 

PRESSNL 

Newline entered, screen clears 
SPELL 

DRAGUN 

Screen clears 

DRAGUN IS WRONG — IT WAS 
DRAGON 


and so on 
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PROGRAM LISTING 


20 LET M=1 
30 DIM С(50) 
40 DIM S(5) 
50 DIM E(5) | 
70 PRINT “ENTER 5 WORDS” 
80 FOR 1=1 TO 5 
90 INPUT W$ 
100 PRINT W$ | 
110 GO SUB 500 
120 NEXT | 
130 CLS 
140 PRINT “THANKS” 
150 STOP 
200 LET Т=0 
205 FOR 1=1 TO 5 
210 PRINT “МОВО” =", 
215 LET J=99 
220 GO SUB 600 
225 PRINT “PRESS NL” 
230 INPUT Z$ 
240 CLS 
250 PRINT "SPELL" 
260 INPUT XS 


265 CLS 

270 PRINT X$5;" 15“ 

280 FOR Ј=5(1) TO Е(І) 

290 IF X$=”” THEN GO TO 360 

300 IF NOT CODE (X$)=C(J) THEN GO TO 360 
310 LET Х%-Т1%(Х6) 

315 NEXT J 

317 IF NOT X$-"" THEN GO TO 360 
320 PRINT "CORRECT" 

330 LET Т=Т+1 

340 GO TO 380 


360 PRINT “WRONG — IT WAS" 
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PROGRAM LISTING continued 


370 GOSUB 600 

380 PRINT 

400 NEXT I 

420 PRINT 

430 PRINT "END. YOU GOT “:T;“RIGHT’’ 
499 STOP 

500 IF W$=”” THEN STOP 

505 IF M«51 THEN GO TO 510 
507 PRINT "WORDS TOO LONG" 
508 STOP 

510 LET S(I)2M 

520 LET C(M)=CODE(W$)} 

530 LET М/%-ТІ%(//%) 

540 LET Е(1)=М 

550 LET М-М+ 1 

560 IF W$=”” THEN RETURN 
570 GO TO 520 

600 FOR К-5(1) TO Е (1) 

602 IF K«J THEN GO TO 610 
604 PRINT CHR$(C(K)+128); 
606 GO TO 620 

610 PRINT CHR$(C(K)); 

620 NEXT K 

630 PRINT 

640 RETURN 
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LINSAC REF. МО. Е005 | DOCUMENTATION 
GRAPH PLOTTER 


PROGRAM DESCRIPTION 


Plots a graph of the equation ax? + bx + c on positive labelled x and y 
axes. X axis is vertical and y horizontal. 


20 lines used for x axis, 15 characters for y axis. 


INSTRUCTIONS 
Press RUN. 


On invitation enter values for A, B and C and maximum x and y axis 
values, each terminated by NEWLINE. 


If the resulting equations would be out of the specified axes range at any 
. point, then the program reveals this and stops. Otherwise the graph is 
plotted by dots and labelled x and y axes. 


N.B. If the graph is plotted generally close to the maximum value of 
the y axis then plotting may terminate prematurely. To remedy this re- 
run with a higher value for the y maximum. 


LIST OF VARIABLES 
Array Y = scaled values of y = ах? + bx + с 
O = width in characters of graph 
А,В,С =  valuesin the equation у = ах? + bx + с 
М - max.value on x-axis 
М = max. value on y-axis 
X = scaled counter for x-axis 
Е =  truevalue on x-axis 
Y = true value on y-axis 
SAMPLE RUN 


TO PLOT EQUATION AX2 + ВХ + C ENTER 
А=1 В-0 С=5 
X-AXIS TO 10 Y-AXIS TO 110 
Screen clears 
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REF. МО. Е005 DOCUMENTATION 
GRAPH PLOTTER 


SAMPLE RUN continued 


0 55 110 Y 


and program terminates 


PROGRAM LISTING 


10 DIM Y(20) 
15 LET O=15 
30 PRINT “TO PLOT EOUATION AX2+BX+C ENTER:” 
40 PRINT “A=”; 
БО INPUT A 
60 PRINT А.” B=”; 
80 INPUT B 
90 PRINT В“ C=": 
100 INPUT C 
110 PRINT C 
120 PRINT “Х--АХІ5 ТО“; 
130 INPUT M 
140 IF М>99 OR M« 10 THEN GO TO 130 
150 PRINT M;" Y—AXIS ТО“. 
160 INPUT N 
170 IF М>999 OR N« 10 THEN GO TO 160 
180 PRINT N 
190 FOR Х-0 TO 20 
200 LET Е=Х *М/20 | 
210 LET Ү(Х)=(А*Е*Е+В *Е+С) *О/М 
220 IF Ү(Х)<О OR Y(X)» 3 THEN GO ТО 550 
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РВОСВАМ LISTING continued 


230 NEXT X 
240 CLS 


250 PRINT ” 0“. 

260 LET Ү-М/2 

270 СО SUB 600 

320 LET Ү-М 

330 GO SUB 600 

340 PRINT “ Y"s 

350 FOR X=0 ТО 20 

360 IF X=(X/5)*5 THEN GO TO 420 
380 PRINT “ "7: 

390 GO TO 445 

420 LET Е-Х“М/20 

‘430 PRINT E; 

440 IF E« 10 THEN PRINT “ ”: 
445 IF Y(X)«2 THEN GO TO 480 
450 FOR 1=1 ТО Ү(Х)-1 

460 PRINT ““. 

470 NEXT | 

480 РА! МТ“. 

490 МЕХТ Х 

495 PRINT “X” 

500 STOP 

550 PRINT "OUT OF RANGE AT Х<” Е. 
560 STOP 


600PRINT" “. 

610 IF Y« 100 THEN PRINT " ”: 
620 IF Y<10 THEN PRINT “ ""; 
630 PRINT У; 

640 RETURN 


LINSAC REF. МО. (5005 DOCUMENTATION 


HURKLE 
PROGRAM DESCRIPTION 
A 'Hurkle' is chosen to be at a random position In a 15 x 15 grid and the 
player has 5 goes at finding its position. After each guess he is told in 


which direction to move. 


After five unsuccessful guesses the hurkle is revealed. 


INSTRUCTIONS 
Press RUN 
Type NEWLINE when prompted 


There is some delay between each grid display. X axis is horizontal and 
Y axis 15 vertical. 


Input X and Y quesses when prompted, terminating each by NEWLINE. 
Y our position is shown by the go number. 


At the end the hurkle's position is shown by H. 


LIST OF VARIABLES 


2% = dummy variable 

A = x co-ordinate of Hurkle 

B = y co-ordinate of Hurkle 

C = x co-ordinate guessed by player 

D = y co-ordinate guessed by player 

| = number of guess 

Y = counter used to display grid 
SAMPLE RUN 

A HURKLE IS HIDING IN 

A 15 x 15 GRID 


YOU HAVE 5 TRIES TO FIND HIM 
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REF. МО. 6005 
HURKLE 


SAMPLE RUN continued 


PRESS N/L | 
Newline entered, screen clears 


= N G) Оо O ~ CO 


1234567890, | | | || 
0123 45 


PROGRAM LISTING 


2 REM HURKLE 
4 GO TO 48 

6 CLS 

8 LET Y=15 ме 
10 IF Y« 10 THEN PRINT "^. 

12 PRINT Y;" Зея 


DOCUMENTATION 


14 LET Ү-Ү-1 

16 IF У>0 THEN GO TO 10 |. 
18 PRINT “(123456789111114 
012345" 


20 PRINT ,” 

22 PRINT ` 

24 PRINT 1;".X-"'; 21 SPace 5 

26 INPUT C 2. sPaeds 


28 PRINT C;” Y=”; 
58 есе 
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PROGRAM LISTING continued 


30 INPUT D 

32 PRINT D; 

34 IF C=A AND D=B THEN GO TO 72 

36 POKE 17262+C —18*D,156+I 

38 IF 1=5 THEN RETURN 

ДО PRINT ".. СО ";CHR$(—51*(D«B)—56*(D»B)); 
CHR$(— 42*(C<A) —60* (C» A)) 

42 PRINT "PRESS N/L” 

44 INPUT Z$ 

46 RETURN 

48 RANDOMISE | 

50 PRINT "A HURKLE IS HIDING IN",,"A 15x15 GRID”,,, 
"YOU HAVE 5 TRIES TO FIND HIM" 

52 GO SUB 42 

54 LET 7%-”” 

56 LET A=RND(15) 

58 LET B=RND(15) 

60 FOR 1=1 ТО 5 

62 GO SUB 6 

64 NEXT | 

66 PRINT 

68 PRINT "SORRY. IT WAS “;A;” ";В 

70GOTO74 | 

72 PRINT " WELL DONE” 

74 POKE 17262*A—18*B, 173 

76 CLEAR 

78 GO SUB 42 

80 CLS 

82 IF 2% =""" THEN RUN 
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LINSAC REF. NO. G016 | DOCUMENTATION 


4-IN-A-LINE (2K) 
Authors : R. Turner & C. Thornton 


PROGRAM DESCRIPTION 


T his is a game for two players. The players move in turn. For his turn 
each player can 'drop' a counter into 1 of 7 columns. However the 
counters are subject to gravity and so fall to the lowest unoccupied 
square. 


The winner is the first player to get 4-IN-A-LINE either horizontally, 
vertically or diagonally. 


The computer checks for winning lines and displays a message if anyone 
wins (or if you try to cheat!) 


INSTRUCTIONS FOR USE 


. The computer will display a 6 by 7 grid on the screen. It will also show 
at the bottom of the grid whose move it is and which symbol represents 
that player. If there are no empty squares and no one has won then the 
computer will declare it a draw. 


LIST OF VARIABLES 


A(42) = Positions in board. Contains code for character 

at that position. 

C = Variable to store whose move it Is. 

Z = Your move. Also used in loop when printing 
board. m О 

А,В = Used in loops when printing board. 

О,Е,С,! = Temporary variables to check if anyone has 

and K won. 

A$ = Response to question “play again?” 


PROGRAM LISTING 


6 LET C=—1 
7 DIMA(42) 
15 GO SUB 90 
16 GO TO 300 
17 PRINT "1 TO 7 PLAYER “ CHR$(39+C);” ';CHR$(19—C) 
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PROGRAM LISTING continued 


18 LET С-С-О AND —1 OR C=—1 AND 0 
19 INPUT Z 

20 IF 2>7 OR 2< 1 THEN GO TO 19 
23 GO SUB 170 

25 CLS 

30 GO TO 15 

90 PRINT, “4 МА LINE" 

93 PRINT 

97PRINT"12 3 4 5 6 7” 
100 FOR A= 1 TO 6 

130PRINT" I| l I 1 Í! 1" 


135 FOR 2-0 TO 5 < sur Q 
140 PRINT " “;CHR$(A(42—(Z*6+A)));“ f”; 
145 NEXT Z 


150 PRINT CHR$(A(42—(Z*6+A))) 
155 FOR В=1 ТО 6 


156 PRINT “m ша m" ;CHRS(133); 

157 NEXT B К 
158 PRINT "am "y мо SPACES Bennek 
160 NEXT A смес ал 

165 RETURN 


170 FOR A=0 ТО 41 

180 IF А(А)-О ТНЕМ СО ТО 200 

185 NEXT А 

190 PRINT “ DRAW ” 

195 GO TO 810 

200 LET 27—2 

205 FOR A-0 TO 5 

210 IF А((2*6+А))=0 THEN GO TO 250 

220 NEXT A | 

230 PRINT “ FULL ”; 

235 INPUT Z 

240 IF 2>7 ОН 2< 1 THEN GO TO 235 

245 GO TO 200 

250 LET A((Z*6+A))=20+C 

260 RETURN 

300 FOR A=0 TO 3 

305 FOR B=0 TO 5 | 

310 LET D=A(B+A*6)+A(A*6+B+6)+A(A*6+B+12)+A(A*6 
+B+18) 

320 IF D=80 THEN GO TO 700 

330 IF D=76 THEN GO TO 800 
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РНОС НАМ LISTING continued 


340 NEXT B 

342 NEXT A 

345 FOR A=0 TO 3 

350 FOR B=0 TO 2 

360 LET D=A(A*6+B}A(A*6+B+7)+A(A*6+B+14)+ 
А(А“6+В+21) 

370 LET К=36+В —(А *6) 

380 LET E=A(K)+A(K—5)+A(K—10)+A(K—15) 

384 IF D=80 ОК Е=80 THEN СО ТО 700 

386 IF D=76 OR Е=76 THEN GO TO 800 | 

387 МЕХТ В 

388 МЕХТА 

390 FOR B=0 ТО 6 

390 FOR Ғ-0 ТО 2 

400 LET 1-6“В 

410 LET G= A(I+F)+A(I+F+1)+A(I+F+2)+A(I+F+3) 

420 IF G=80 THEN GO TO 700 x 

430 IF G=76 THEN GO TO 800 

440 NEXT F 

450 NEXT B 

460 GO TO 17 | 

700 PRINT " WELL DONE PLAYER A” 

710 GO TO 810 

800PRINT "WELL DONE PLAYER B" 

810 PRINT "PRESS NEWLINE TO PLAY AGAIN” 

820 CLEAR 

830 INPUT A$ 

835 CLS 

840 IF A$E” THEN GO TO 1 

850 PRINT "BYE — THANKS FOR PLAYING” 
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REF. МО. 6016 DOCUMENTATION 


4-IN-A-LINE 
SAMPLE RUN 
Moves of Each Player 
Player A | Р!ауег В 
1 1 
2 3 
2 4 
5 4 
3 3 
4 2 
2 3 
ДІМА LINE 
1 2 3 4 5 6 7 


+ 
| |+ 
(Alternates) 


1TO 7 PLAYER А“ 
1TO 7 PLAYER В+ 


WELL DONE PLAYERA 
PRESS NEWLINE TO PLAY AGAIN 
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LINSAC REF. МО. 6009 DOCUMENTATION 


THE MAZE GAME 
Author : Mark Porter 


PROGRAM DESCRIPTION 


You are at the point X, You must reach the treasure (£) at the other 
corner by pressing the arrowed keys to move. At first glance it may seem 
easy, but as time goes on more and more of the blanks are filled т..... 


INSTRUCTIONS 
Press RUN. 


For your move, enter a number from the range 5—9 or O. 


5,6,7,8 give movement in the arrowed direction 

9 resets the X to the beginning — but the obstacle remains 

0 If you can't move, or һауе got as close as you think you can, 
press this to obtain your score 


any other number 15 ignored. 


LIST OF VARIABLES 


Array to hold maze element status values 

Loop counter to set up array 

Loop counter to print maze 

User's move 

Loop counter to update array 

Random number in range 2—99 to pick element to 
update 

Element number of user's position 

Buffer recording of X used to check validity of D 


A 


c m су o © 
uU Hn Hn Ww H I 


< X 


_ SAMPLE RUN 


A regular pattern of black squares appears, with an X in the top left 
corner, and the treasure in the bottom right. 


Enter 6 and press N/L. 


T he display blanks for a few seconds, and then reappears with the X 
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REF. МО. 5009 DOCUMENTATION 
THE MAZE GAME 
SAMPLE RUN continued 


moved down by one square. 


T here's nothing to this, just pressing 6 and 8 to reach Е but after the 
fourth keystroke, two black squares appear to block your path. 


T hereafter, more and more of the passageways аге filled in, until either · 
you reach the treasure or are trapped in the maze. 


COMMENTS 


Though the program listing only contains 39 lines, the array A and the 
graphic display take up a lot of the RAM space. Alterations to the 
program must therefore be balanced in order that error 4 is not en- 
countered. 


The loop E goes around 8 times, but each element must be picked twice 
for it to become blocked. This helps to maintain the number of squares 
blacking over at an approximately equal number in the middle of the 
game, and also makes it rather more difficult to retrace one's route after 
a couple of goes, though it usually remains open for a time. The func- 
tion on line 205 is merely a subtraction from 18 of the number of moves 
to £, with like terms collected. In practice it is identical to the number 
of times the keys 6 and 8 have been used, less the number of times that 
5 and 7 have been pressed, if 9 is not used. | 


PROGRAM LISTING 


10 RANDOMISE 
70 DIM А(99) 
80 FOR B=2 TO 99 
' 90 LET A(B)=2*((B/4)*4=B)+3 
100 NEXT В 
102 LET А(1)-4 
104 LET X=1 
110 FOR C=1 TO99 
120 IF A(C)=4 THEN PRINT “X”; 
130 IF A(C)=3 OR A(C)=2 THEN PRINT ““; 
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PROGRAM LISTING continued 


150 IF A(C)=1 THEN PRINT CHR$(128); 
160 IF C299 THEN GO ТО 185 
170 IF (C/10)* 102C THEN PRINT 


180 NEXT С, — —— (ВУ Paint £ 
190 PRINT “ENTER MOVE:" 
200 INPUT D 


202 IF NOT D=0 THEN GO TO 210 

205 PRINT “SCORE="";X+(X+10)/10+((100—X)/10) * 10—92;" 
/18” 

207 STOP 

210 LET Y=X 

220 LET Y=(1—Y)*(D=5) —(Y+10) *(D=6)—(Y—10)*(D=7) 
—(\+1)*(0=8)—(0=9) 

2/0 IF У> 100 OR Y«1 THEN GO TO 190 

2/5 IF NOT Y2100 THEN GO TO 300 

280 PRINT “YOU WIN. SCORE218/18" 

290 STOP 

295 IF A(Y)21 OR Y=X THEN GO TO 190 

З001 ЕТ А(Ү)-4 

310 LET А(Х)-2 

320 LET X=Y 

330 FOR E21 ТО 8 

340 LET F=RND(98)+1 

345 IF Е=Х THEN LET F=F+1 

350 LET A(F)=A(F)—1 

360 IF A(F)<1 THEN LET A(F)=1 

3/0 NEXT E 

390 CLS 

390 GO TO 110 
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APPENDIX ONE 


COMPARISON OF 280 INSTRUCTION CODES & ZX80 CHARACTER 
SET 


115 


DEC HEX OP Code Character 
0 00 NOP space 
1 01 LD BC,nn null string 
2 02 LD (ВС),А | 
3 03 ІМС ВС Ez 
4 04 INC B Е | 
5 05 DEC В R. 
6 06 LD Вп m | 
7 07 RLCA [m 
8 08 ЕХ AF,AF’ ы” 
9 09 ADD HL,BC ЕН 

10 ОА LD А (ВС) A 
11 OB DEC BC ашы 
12 ОС INC С Ғ 
13 OD DEC C $ 
14 OE LD Сп : 
15 OF RRCA ? 
16 10 DJNZ disp ( 
17 11 ГО ОЕ пп ) 
18 12 LD (ОЕ), А — 
19 13 INC DE + 

20 14 INC D Б 

21 15 DEC D / 

22 16 ГО D,n = 

23 17 RLA > 

24 18 JR disp < 

25 19 ADD HL,DE : 

26 1A LD A,(DE) | 

27 18 DEC DE 

28 1C INC E 0 

29 1D DEC E 1 

30 1E ГО Еп 2 


ОЕС НЕХ ОР Соде 
31: 1F RRA 3 
32 20 JR NZ,disp 4 
33 21 LD HL,nn 5 
34 22 [О (пп), HL 6 
ЗБ 23 INC HL 7 
36 24 INC H 8 
37 25 DEC H 9 
38 26 LD H,n A 
39 27 DAA B 
40 28 JR Z,disp % 
41 29 ADD HL,HL D 
42 2A LD HL,(nn) E 
43 2B DEC HL F 
44 2C INC L G 
45 2D DEC L H 
46 2Е LD L,n | 
47 2Е CPL J 
48 30 JR NC,disp K 
49 31 LD SP,nn L 
50 32 LD(nn),A M 
51 33 INC SP N 
52 34 INC(HL) O 
53 35 DEC(HL) P 
54 36 LD (HL),n o 
55 37 SCF R 
56 38 JR C,disp S 
57 39 ADD HL,SP Т 
58 ЗА LD А (пп) U 
59 3B DEC SP V 
60 3C INC A W 
61 3D DECA X 
62 3E LD A,n Y 
63 3F CCF Z 
64 40 LD B,B ? 
N.B. n = single byte number пп = twobyte number 


disp= displacement (nn) address 
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DEC 


65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
100 
101 


НЕХ 


41 

42 
43 
44 
45 
46 
47 
48 
49 
4A 
4B 
4C 
4D 
4E 
4F 
50 
51 

52 
53 
54 
55 
56 
57 
58 
59 
5A 
5B 
5C 
5D 
5E 
БЕ 
60 
61 

62 
63 
64 
65 


ОР Соде 
LD B,C 
LD B,D 
LD В,Е 
LD B,H 
LD B,L 


LD B,(HL) 


LD B,A 
LD C,B 
LD C,C 
LD C,D 
LD C,E 
LD C,H 
LD C,L 


LD C,(HL) 


LD C,A 
LD D.B 
LD D,C 
LD D,D 
LD D,E 
LD D,H 
LD D,L 


LD D,(HL) 


LD D,A 
LD Е,В 
LD E,C 
LD E,D 
LD Е,Е 
LD E,H 
LD E,L 


LD Е (НЕ) 


LD E,A 
LD H,B 
LD H,C 
LD H,D 
LD H,E 
LD H,H 
LD H,L 
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ОЕС 


101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 

117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 


НЕХ 


65 
66 
67 
68 
69 
бА 
6B 
6C 
6D 
6E 
6F 
70 
71 

72 
73 
74 
75 
76 
77 
78 
79 
7A 
7B 
7C 
7D 
7E 
7F 
80 
81 

82 
83 
84 
85 


86. 


87 
88 
89 


ОР Соде 
LD H,L 
LD H,(HL) 
LD НА 
LD L,B 
LD L,C 
LD L,D 
LD Г Е 
LD L,H 
LD L,L 
LD L,(HL) 
LD L,A 
LD (HL),B 
LD (HL),C 
LD(HL),D 
LD(HL),E 
LD(HL),H 
LD(HL),L 
HALT 
LD(HL),A 
LD A,B 
LD A,C 
LD A,D 
LD A,E 
LD A,H 
LD A,L 
LD A,(HL) 
LD A,A 
ADD A,B 
ADD A,C 
ADD A,D 
ADD АЕ 
ADD A,H 
ADD A,L 
ADD A,(HL) 
ADD A,A 
ADC A,B 
ADC A,C 
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е J уу Ag Ag САД) САД САД САД М САД ЗАД ЗАД УМ А САД) САД) САД САД САД САД САД САД САД САД САД 0 


Character 


inverse quote 


ERA kis 


ОЕС 


138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 


НЕХ 


ВА 
8B 
8C 
8D 
ВЕ 
ВЕ 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
ЗА 
9B 
9C 
9D 
9E 
OF 
AO 
А1 
А2 
АЗ 
A4 
Ab 
A6 
A7 
A8 
A9 
AA 
AB 
AC 
AD 
AE 


OP Code 
ADC A,D 
ADC A,E 
ADC A,H 
ADC A,L 
ADC A,(HL) 
ADC A,A 
SUB B 
SUB C 
SUB D 
SUB E 
SUB H 
SUB L 
SUB (HL) 
SUB A 
SBC A,B 
SBC A,C 
SBC A,D 
SBC A,E 
SBC A,H 
SBC A,L 
SBC A,(HL) 
SBC A,A 
AND B 
AND C 
AND D 
AND E 
AND H 
АКО L 
AND (НІ) 
АМО А 
ХОВ В 
ХОК С 
XOR D 
XOR E 
XOR H 
XOR L 
XOR (HL) 
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Character 
же. 
E 


inverse £ 
inverse $ 
Inverse : 

inverse ? 
inverse ( 

inverse ) 

Inverse — 
Inverse t 
inverse * 
inverse / 

Inverse - 
Inverse > 
Inverse « 
Inverse ; 

Inverse , 

Inverse . 

inverse 0 
inverse 1 

inverse 2 
inverse 3 
inverse 4 
inverse 5 
inverse 6 
inverse 7 
inverse 8 
inverse 9 
Inverse A 
inverse B 
inverse C 
inverse D 
inverse E 
inverse F 
inverse G 
inverse H 
inverse I 


ОЕС 
175. 


176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
| 190 

191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 


НЕХ 


АЕ 
ВО 
В1 
В2 
ВЗ 
В4 
В5 
В6 
В7 
В8 
В9 
ВА 
ВВ 
ВС 
ВО 
ВЕ 
ВЕ 
СО 
C1 
C2 
C3 
C4 
C5 
C6 
C7 
C8 
C9 
CA 
CB 
CC 
CD 
CE 
CF 
DO 
D1 
D2 
D3 


OP Code 
XOR A 
ОВ В 
OR С 
OR D 
ОВ Е 
OR H 
OR L 
OR (HL) 
ORA 
CP B 
CPC 
CP D 
CPE 
CP H 
CPL 
CP (HL) 
CP (A) 
RET NZ 
POP BC 


JP NZ,nn 


JP nn 


CALL NZ,nn 


PUSH BC 


ADD A,n 


RST O 
RET Z 
RET 

JP Z,nn 


"~, "J "~, "J "~, "~, "~, "~, "~, ...) Ж.) 


Сһагастег 
inverse J 
Inverse K 
Inverse L 
Inverse M 
inverse |М 
Inverse O 
inverse P 
inverse О 
Inverse R 
inverse S 
Inverse T 
Inverse U 
Inverse V 
inverse W 
Inverse X 
inverse Y 
Inverse Z 


two byte Instruction code ? 


CALL Z,nn 


CALL пп 
АОС А,п 
RST 8 
НЕТ МС 
РОР DE 
JP NC,nn 


OUT ро А 
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"~, "~, "~, "~, "~, ...) "~, „~, 


ОЕС 


212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 


НЕХ 


04 
D5 
D6 
D7 
D8 
D9 
DA 
DB 
DC 
DD 
DE 
DF 
EO 
E1 
Е2 
E3 
E4 
Е5 
Еб 
Е/ 
E8 
E9 
EA 
EB 
EC 
ED 
EE 
EF 
FO 
F 1 
F2 
= 
F4 
F5 
F6 
F7 
F8 


OP Code 
CALL МС пп 
РОЗН ПЕ 
SUB п 
RST 10H 
RET C 
EXX 
JP C,nn 
IN A,port 
CALL C,nn 
two byte instruction code 
SBC A,n 
RST 18H 
RET PO 
POP HL 
JP РО пп 
ЕХ (SP),HL 
CALL PO,nn 
PUSH HL 
AND n 
RST 20H 
RET PE 
JP (HL) 
JP · PE,nn 
EX DE,HL 
CALL PE,nn 
two byte instruction code 
XOR n 
RST 28H 
RET P 
POP AF 
JP P,nn 
D | 
CALL P,nn 
PUSH AF 
ORn 
RST 30H 
ВЕТ M 
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Character 
THEN 
TO 


LIST 
RETURN 
CLS 

DIM 
SAVE 
FOR 

GO TO 
POKE 
INPUT 


RANDOMISE 


LET 


ОЕС НЕХ ОР Соде Сһагастег 


249 F9 LDSP,HL ` CONTINUE 
250 РА JP М,пп ІР 

251 ЕВ Е! СО SUB 
252 РС CALL M,nn LOAD 
253 FD two byte instruction code CLEAR 
254 ҒЕ СРп КЕМ 


255 FF RST 38H ? 
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APPENDIX TWO — THE ВК КОМ 


A2.1 INTRODUCTION 


Тһе long-awaited 8K BASIC ROM for Ше ZX80 was launched at the 
Third Personal Computer World Show, 4 - 6 September 1980 in London. 
This coincided with the time at which this edition was going to print 

and the following section is based upon initial use of a prototype. 
Material is reproduced from the Sinclair specification sheet with per- 
mission of Science of Cambridge. 


The new ROM is sold as a plug-in replacement for the 4KROM described | 
in this volume. It comes with a new keyboard template to provide for 
the new BASIC functions and instructions. This looks like: 


READ RESTORE REM INPUT POKE PRINT 
АЕ ЖЕ: ЖҮ | ОВ 


л. 


құй” RND STRS CHRS CODE — 
GO SUB LOAD LIST 


те, ARCCOS тт. USR 


CLEAR am NEXT LL BRE er 


IN KEYS 


Sinclar ZX80 8K BASIC 


A.2.2 NEW FEATURES 


Data Storage 


Numbers are stored in five bytes in floating point binary form giving a 
. range of numbers 


9x 10-44 < n< 1.1х 1023 


Numbers cannot be defined as integers, but storage of integers between 
О and 255 can Бе achieved by the “fiddle” of using character codes of 
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string-defined variables. 


String arrays are available and must be dimensioned. Substrings are 
obtained by the keyword TO, e.g. 


99 LET B$ = A$ (? TO 4) 


Undimensioned strings are still available but these may now be concaten- 
ated using the + operator. 


Instructions 


READ, DATA and RESTORE statements are available in their standard 
form. | 


Graph plotting is achieved by several new instructions. Each uses 
pixels (quarter character squares). 


1) PLOT x,y blacks in a pixel at coordinate (x,y). The screen 
consists of 64 positions in the x—direction and 44 in the 
y—direction; both increment in the normal graph directions. 


2) UNPLOT x,y blanks out a pixel at (x,y) 


3) DRAW a,b draws a line from the current PLOT position, say 
(х,у), to (ха, у+Ь). 


4) UNDRAW a,b — reverse of DRAW. 


A GRAPHICS key is included to allow ALL characters and their inverses 
to be entered from the keyboard. 


Named cassette program files are now available using 


SAVE filename and LOAD filename 


The authors cannot comment on its usefulness as this has not been 
assessed. 


A STEP feature is now included in FOR statements 
e.g. FOR 1=1 TO 20 STEP 4 


Different PRINT options are specified so that the user can print at a 
given position on the screen 
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е.д. PRINT АТ 10,20 
or print to a given number of digits or in E format 
e.g. PRINT ТО 4. 


Тһе system variable КАМТОР тау Бе altered using NEW n, іп order to 
protect machine code programs stored above it (see Section 4.7). 


Finally, moving display features are included. The statement SCRO LL 
causes the display file to SCROLL up one line. Also, the piece de 
resistance, the PAUSE n instruction sends the display file to the screen 
for n frames or until a key Is pressed. 


Functions 


A function key is included above NEWLINE. The table below shows 
new functions only. 


ARCOS number 


ARCSIN 
ARCTAN 
COS 
SIN 
T 


AN 
character scans keyboard and obtains character 

of key depressed (if any) 
ә - 


standard trigonometrical functions 


(using radians) 


=f TT 631416027 
sign (1, б ог +1 
SORT 


Operators 
Combinations of relational operators are permitted, e.g.. 


‚ >= and <> (not equal to) 
125 


<= 


А2.3 SAMPLE PROGRAM 


The new owner will probably be most Interested in seeing a demonstra- 
tion of the moving display. The following simple program demonstrates 
some of these features : 


10 PRINT "MOVING DISPLAY” 
20 PRINT “--------------” 
30 PRINT "DIRECTION OF MOVEMENT:” 
40 PRINT “I. NORTH” 
50 PRINT “2. EAST" 
60 PRINT "3, NORTH-EAST” 
. JO PRINT “INPUT 1,2 ОВ 3" 
80 INPUT N 
90 LET N=INT(N) 
100 IF МЗ OR N«1 THEN GO TO 80 
110 PRINT N 
120 IF N21 THEN GO TO 180 
130 PRINT "ENTER TIME BETWEEN MOVES" 
140 PRINT "IN TENTHS OF SECONDS" 
150 INPUTT 
160 LET T=INT(T) 
170 IF T<5 OR T» 100 THEN GO TO 150 
180 CLS 
190 PLOT 1,1 
199 GO TO 50“ М+150 
200 FOR 121 TO 15 
210 SCROLL 
220 NEXT | 
249 STOP 
250 FOR 1=2 TO 40 
260 UNPLOT 1-1,1 
270 PLOT 1,1 
280 PAUSE T *5 
290 NEXT | 
299 STOP 
300 FOR 1-2 TO 40 
310 UNPLOT 1—1,1—1 
320 PLOT 1, 
330 PAUSE T *5 
340 NEXT | 
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INDEX 


ABS 27, 32 

Arrays Sect. 3.5, 42 

Arithmetic subroutines Sect. 4.6 
Assembly 81 

Assignments & Calculations Sect. 3.2 
Bits 15, 16 


· Books 44 


Bytes 15 

Cassette interface 86 
Cassette recorder 7, 8, 9 
Character printing routine 69 
Characters Sect. 3.6, 84 
Characters table 54 

CHRs 27,52 

CLEAR 25 

CLS 26 

CLS routine 69 

CODE 27 

Commands 24 

Conditions Sect. 3.4, 86 
Connections 7 

Construction & hardware — Chapter 5 
CONTINUE 12, 25 

Current display position 67 
Current position store routine 69 
Cursor 24 

Cursor table 56 

Debugging 20 

DIM 26, 38 

Display file 23, 63 
Documentation 21 

Edge connector 87 

EDIT 23 

End of program sequence 70 
Expressions 28 

Flowcharts 18, 19 

. FOR statement 37 
Four-in-a-line 108 
Functions 26, 31, 40 

GO SUB 26, 35 

GO TO 25, 34 


Graph plotter 102 

Hurkle 105 

IC's 90 

IF statement 26, 35 

Input || 

INPUT statement 25, 32 
Input device 14 
Instructions 25b 

Integers 32 

Interpreter 17 

Interrupting programs 12 
Inverse printing 47 

Jumps Sect. 3.4 

Keyboard 86 

Keywords 10, 24 
Languages 1/ 

LET 25, 28 

Lines 23 

LIST 24 

LOAD 24 

LOAD routine 62 

Loading from cassette Sect. 1.3 
Loading from listings Sect. 1.4 
Logical operators 30 
Logical values 29 

Machine Code Sect. 3.7, Chap. 4 
Main memory 15 

Masking 30 

Maze Game 112 

Memory display 95 

Modes II 

Modules 18 

Monitor Chap. 4 

Moving display routine Sect. 4.8 
Moving RAMTOP down 77 
NEW 25 

New ROM — Appendix 2 
Number printing routine 72 
Operators 37, 36 

Output device 14 

Pattern recognition 91 


INDEX cont'd 


PCB 82 

PEEK 27,44, 51 

POKE 26,44 

Power supply 9,82,87 
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